fungsi acmFilterEnum (msacm.h)

Artikel
02/29/2024

Fungsi acmFilterEnum menghitung filter waveform-audio yang tersedia untuk tag filter tertentu dari driver ACM. Fungsi ini terus menghitung sampai tidak ada lagi filter yang cocok untuk tag filter atau fungsi panggilan balik mengembalikan FALSE.

Sintaks

MMRESULT ACMAPI acmFilterEnum(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  ACMFILTERENUMCB    fnCallback,
  DWORD_PTR          dwInstance,
  DWORD              fdwEnum
);

Parameter

had

Tangani ke driver ACM untuk mengkueri detail filter waveform-audio. Jika parameter ini adalah NULL, ACM menggunakan detail dari driver ACM pertama yang sesuai.

pafd

Penunjuk ke struktur ACMFILTERDETAILS yang berisi detail filter saat diteruskan ke fungsi yang ditentukan oleh fnCallback. Ketika aplikasi Anda memanggil acmFilterEnum, anggota cbStruct, pwfltr, dan cbwfltr dari struktur ini harus diinisialisasi. Anggota dwFilterTag juga harus diinisialisasi ke WAVE_FILTER_UNKNOWN atau tag filter yang valid.

fnCallback

Alamat instans prosedur dari fungsi panggilan balik yang ditentukan aplikasi.

dwInstance

Nilai yang ditentukan aplikasi 32-bit (DWORD), 64-bit (DWORD_PTR) yang diteruskan ke fungsi panggilan balik bersama dengan detail filter ACM.

fdwEnum

Bendera untuk menghitung filter untuk tag filter tertentu. Nilai berikut didefinisikan.

[ACMFILTERDETAILS] Struktur (./nf-msacm-acmfilterdetails.md) valid. Enumerator hanya akan menghitung filter yang sesuai dengan atribut ini. Anggota dwFilterTag dari struktur ACMFILTERDETAILS harus sama dengan anggota dwFilterTag dari struktur WAVEFILTER .

Nilai	Makna
ACM_FILTERENUMF_DWFILTERTAG

Nilai kembali

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
ACMERR_NOTPOSSIBLE	Detail untuk filter tidak dapat dikembalikan.
MMSYSERR_INVALFLAG	Setidaknya satu bendera tidak valid.
MMSYSERR_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.

Keterangan

Fungsi acmFilterEnum akan mengembalikan MMSYSERR_NOERROR (nol) jika tidak ada driver ACM yang cocok 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
Pustaka	Msacm32.lib
DLL	Msacm32.dll

Lihat juga

Fungsi Pemadatan Audio

Pengelola Kompresi Audio

Bagikan melalui