Fungsi panggilan balik ACMFILTERENUMCBW (msacm.h)

Artikel
11/20/2024

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

Sintaksis

ACMFILTERENUMCBW Acmfilterenumcbw;

BOOL Acmfilterenumcbw(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSW pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Menangani pengidentifikasi driver ACM.

pafd

Penunjuk ke struktur ACMFILTERDETAILS yang berisi detail filter enumerasi untuk tag filter.

dwInstance

Nilai yang ditentukan aplikasi yang 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	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 saat menggunakan filter yang ditentukan. Misalnya, jika driver mendukung pemadatan 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.

Mengembalikan nilai

Fungsi panggilan balik harus mengembalikan TRUE untuk melanjutkan enumerasi atau FALSE untuk menghentikan enumerasi.

Komentar

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.

Nota

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

Bagikan melalui