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

Lihat juga

Fungsi Pemadatan Audio

Pengelola Kompresi Audio