Fungsi panggilan balik ACMFORMATENUMCBA (msacm.h)

Artikel
11/20/2024

Fungsi acmFormatEnumCallback menentukan fungsi panggilan balik yang digunakan dengan fungsi acmFormatEnum . Nama acmFormatEnumCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaksis

ACMFORMATENUMCBA Acmformatenumcba;

BOOL Acmformatenumcba(
  HACMDRIVERID hadid,
  LPACMFORMATDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Menangani pengidentifikasi driver ACM.

pafd

Penunjuk ke struktur ACMFORMATDETAILS yang berisi detail format enumerasi untuk tag format.

dwInstance

Nilai yang ditentukan aplikasi yang ditentukan dalam fungsi acmFormatEnum .

fdwSupport

Bendera dukungan driver khusus untuk driver yang diidentifikasi oleh struktur ACMDRIVERDETAILS , tetapi khusus untuk format yang sedang dijumlahkan. Parameter ini dapat menjadi kombinasi dari nilai berikut dan menunjukkan operasi mana yang didukung driver untuk tag format.

Nilai	Arti
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Driver mendukung konversi asinkron dengan tag filter yang ditentukan.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Driver mendukung konversi antara dua tag format berbeda untuk format yang ditentukan. Misalnya, jika driver mendukung pemadatan dari WAVE_FORMAT_PCM ke WAVE_FORMAT_ADPCM dengan format yang ditentukan, bendera ini diatur.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Driver mendukung konversi antara dua format berbeda dari tag format yang sama saat menggunakan format yang ditentukan. Misalnya, jika driver mendukung pengambilan sampel ulang WAVE_FORMAT_PCM ke format yang ditentukan, bendera ini diatur.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Driver mendukung filter (modifikasi data tanpa mengubah atribut format apa pun) dengan format yang ditentukan. Misalnya, jika driver mendukung operasi volume atau gema pada WAVE_FORMAT_PCM, bendera ini diatur.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Driver mendukung input perangkat keras, output, atau kedua tag format yang ditentukan melalui perangkat waveform-audio. Aplikasi harus menggunakan fungsi acmMetrics dengan indeks metrik ACM_METRIC_HARDWARE_WAVE_INPUT dan ACM_METRIC_HARDWARE_WAVE_OUTPUT untuk mendapatkan pengidentifikasi perangkat waveform-audio yang terkait dengan driver ACM pendukung.

Mengembalikan nilai

Fungsi panggilan balik harus mengembalikan TRUE untuk melanjutkan enumerasi atau FALSE untuk menghentikan enumerasi.

Komentar

Fungsi acmFormatEnum akan mengembalikan MMSYSERR_NOERROR (nol) jika tidak ada format yang akan dijumlahkan. Selain itu, fungsi panggilan balik tidak akan dipanggil.

Fungsi berikut tidak boleh dipanggil dari dalam fungsi panggilan balik: acmDriverAdd, acmDriverRemove, dan acmDriverPriority.

Nota

Header msacm.h mendefinisikan ACMFORMATENUMCB sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	msacm.h

Lihat juga

Fungsi Kompresi Audio

Pengelola Kompresi Audio

Bagikan melalui