Fungsi panggilan balik ACMFILTERENUMCB (msacm.h)
Fungsi acmFilterEnumCallback menentukan fungsi panggilan balik yang digunakan dengan fungsi acmFilterEnum . Nama acmFilterEnumCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
ACMFILTERENUMCB Acmfilterenumcb;
BOOL Acmfilterenumcb(
HACMDRIVERID hadid,
LPACMFILTERDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Tangani ke pengidentifikasi driver ACM.
pafd
Penunjuk ke struktur ACMFILTERDETAILS yang berisi detail filter enumerasi untuk tag filter.
dwInstance
Nilai yang ditentukan aplikasi ditentukan dalam acmFilterEnum.
fdwSupport
Bendera dukungan driver khusus untuk driver yang diidentifikasi oleh struktur ACMDRIVERDETAILS , tetapi khusus untuk filter yang sedang dijumlahkan. Parameter ini dapat menjadi kombinasi dari nilai berikut dan mengidentifikasi operasi mana yang didukung driver untuk tag filter.
| Nilai | Makna |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | Driver mendukung konversi asinkron dengan tag filter yang ditentukan. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Driver mendukung konversi antara dua tag format yang berbeda saat menggunakan filter yang ditentukan. Misalnya, jika driver mendukung kompresi dari WAVE_FORMAT_PCM ke WAVE_FORMAT_ADPCM dengan filter yang ditentukan, bendera ini diatur. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Driver mendukung konversi antara dua format berbeda dari tag format yang sama saat menggunakan filter yang ditentukan. Misalnya, jika driver mendukung pengambilan sampel ulang WAVE_FORMAT_PCM dengan filter yang ditentukan, bendera ini diatur. |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | Driver mendukung filter (modifikasi data tanpa mengubah atribut format apa pun). 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 keduanya dengan filter 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 acmFilterEnum akan mengembalikan MMSYSERR_NOERROR (nol) jika tidak ada filter 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 |