fungsi acmFilterEnumA (msacm.h)

Artikel
11/20/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.

Sintaksis

MMRESULT ACMAPI acmFilterEnumA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  ACMFILTERENUMCBA    fnCallback,
  DWORD_PTR           dwInstance,
  DWORD               fdwEnum
);

Parameter

had

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

pafd

Penunjuk ke struktur ACMFILTERDETAILS yang berisi detail filter ketika diteruskan ke fungsi yang ditentukan oleh fnCallback. Ketika aplikasi Anda memanggil acmFilterEnum, cbStruct, pwfltr, dan cbwfltr anggota 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 ditentukan.

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

Nilai	Arti
ACM_FILTERENUMF_DWFILTERTAG

Mengembalikan nilai

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

Mengembalikan 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.

Komentar

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.

Nota

Header msacm.h mendefinisikan acmFilterEnum 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
Pustaka	Msacm32.lib
DLL	Msacm32.dll

Lihat juga

Fungsi Kompresi Audio

Pengelola Kompresi Audio

Bagikan melalui