Baca dalam bahasa Inggris

Bagikan melalui

Fungsi panggilan balik ACMFORMATTAGENUMCBW (msacm.h)

  • Artikel

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

Sintaksis

ACMFORMATTAGENUMCBW Acmformattagenumcbw;

BOOL Acmformattagenumcbw(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Menangani pengidentifikasi driver ACM.

paftd

Penunjuk ke struktur ACMFORMATTAGDETAILS yang berisi detail tag format enumerasi.

dwInstance

Nilai yang ditentukan aplikasi yang ditentukan dalam fungsi acmFormatTagEnum .

fdwSupport

Bendera dukungan driver khusus untuk tag format. Bendera ini identik dengan struktur ACMDRIVERDETAILS . Parameter ini dapat menjadi kombinasi dari nilai berikut dan menunjukkan operasi mana yang didukung driver dengan 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 yang berbeda di mana salah satu tag adalah tag format yang ditentukan. Misalnya, jika driver mendukung pemadatan 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 ditentukan. Misalnya, jika driver mendukung pengambilan sampel ulang WAVE_FORMAT_PCM, 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 tag format yang ditentukan, 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 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 acmFormatTagEnum akan mengembalikan MMSYSERR_NOERROR (nol) jika tidak ada tag 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.

Catatan

Header msacm.h mendefinisikan ACMFORMATTAGENUMCB sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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