Fungsi panggilan balik ACMFORMATENUMCB (msacm.h)
Fungsi acmFormatEnumCallback menentukan fungsi panggilan balik yang digunakan dengan fungsi acmFormatEnum . Nama acmFormatEnumCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
ACMFORMATENUMCB Acmformatenumcb;
BOOL Acmformatenumcb(
HACMDRIVERID hadid,
LPACMFORMATDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Tangani ke pengidentifikasi driver ACM.
pafd
Penunjuk ke struktur ACMFORMATDETAILS yang berisi detail format enumerasi untuk tag format.
dwInstance
Nilai yang ditentukan aplikasi ditentukan dalam fungsi acmFormatEnum .
fdwSupport
Bendera dukungan driver khusus untuk driver yang diidentifikasi oleh struktur ACMDRIVERDETAILS , tetapi bendera tersebut 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 | Makna |
|---|---|
| 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. |
Nilai kembali
Fungsi panggilan balik harus mengembalikan TRUE untuk melanjutkan enumerasi atau FALSE untuk menghentikan enumerasi.
Keterangan
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.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | msacm.h |