Fungsi panggilan balik ACMDRIVERENUMCB (msacm.h)
Fungsi acmDriverEnumCallback menentukan fungsi panggilan balik yang digunakan dengan fungsi acmDriverEnum . Nama acmDriverEnumCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Menangani pengidentifikasi driver ACM.
dwInstance
Nilai yang ditentukan aplikasi ditentukan dalam acmDriverEnum.
fdwSupport
Bendera dukungan driver khusus untuk driver yang ditentukan oleh struktur ACMDRIVERDETAILS . Parameter ini bisa menjadi kombinasi dari nilai berikut.
| Nilai | Makna |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | Driver mendukung konversi asinkron. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Driver mendukung konversi antara dua tag format yang berbeda. Misalnya, jika driver mendukung kompresi dari WAVE_FORMAT_PCM ke WAVE_FORMAT_ADPCM, bendera ini diatur. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Driver mendukung konversi antara dua format berbeda dari tag format yang sama. Misalnya, jika driver mendukung pengambilan sampel ulang WAVE_FORMAT_PCM, bendera ini diatur. |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | Driver telah dinonaktifkan. Aplikasi harus menentukan bendera ACM_DRIVERENUMF_DISABLED dengan acmDriverEnum untuk menyertakan driver yang dinonaktifkan dalam enumerasi. |
| 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. |
Nilai kembali
Fungsi panggilan balik harus mengembalikan TRUE untuk melanjutkan enumerasi atau FALSE untuk menghentikan enumerasi.
Keterangan
Fungsi acmDriverEnum akan mengembalikan MMSYSERR_NOERROR (nol) jika tidak ada driver ACM yang diinstal. Selain itu, fungsi panggilan balik tidak akan dipanggil.
Fungsi berikut tidak boleh dipanggil dari dalam fungsi panggilan balik: acmDriverAdd, acmDriverRemove, dan acmDriverPriority.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |