fungsi acmFilterDetails (msacm.h)

Artikel
08/24/2023

Fungsi acmFilterDetails meminta ACM untuk detail tentang filter dengan tag filter waveform-audio tertentu.

Sintaks

MMRESULT ACMAPI acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  DWORD              fdwDetails
);

Parameter

had

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

pafd

Arahkan ke struktur ACMFILTERDETAILS yaitu menerima detail filter untuk tag filter yang diberikan.

fdwDetails

Bendera untuk mendapatkan detailnya. Nilai berikut ditentukan.

[ACMFILTERDETAILS] () struktur diberikan dan detail yang tersisa harus dikembalikan. Anggota dwFilterTag dari struktur ACMFILTERDETAILS harus diinisialisasi ke tag filter yang sama yang ditentukan pwfltr . Jenis kueri ini dapat digunakan untuk mendapatkan deskripsi string dari struktur filter arbitrer. Jika aplikasi menentukan handel driver ACM untuk memilikinya, detail tentang filter akan dikembalikan untuk driver tersebut. Jika aplikasi menentukan NULL untuk dimiliki, ACM menemukan driver pertama yang dapat diterima untuk mengembalikan detailnya.

Nilai	Makna
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	Indeks filter untuk tag filter diberikan pada anggota dwFilterIndex dari struktur ACMFILTERDETAILS . Detail filter akan dikembalikan dalam struktur yang ditentukan oleh pafd. Indeks berkisar dari nol hingga satu kurang dari anggota cStandardFilters yang dikembalikan dalam struktur ACMFILTERTAGDETAILS untuk tag filter. Aplikasi harus menentukan handel driver untuk dimiliki saat mengambil detail filter dengan bendera ini. Untuk informasi tentang anggota apa yang harus diinisialisasi sebelum memanggil fungsi ini, lihat struktur ACMFILTERDETAILS .

Nilai

Makna

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

Indeks filter untuk tag filter diberikan pada anggota dwFilterIndex dari struktur ACMFILTERDETAILS . Detail filter akan dikembalikan dalam struktur yang ditentukan oleh pafd. Indeks berkisar dari nol hingga satu kurang dari anggota cStandardFilters yang dikembalikan dalam struktur ACMFILTERTAGDETAILS untuk tag filter. Aplikasi harus menentukan handel driver untuk dimiliki saat mengambil detail filter dengan bendera ini. Untuk informasi tentang anggota apa yang harus diinisialisasi sebelum memanggil fungsi ini, lihat struktur ACMFILTERDETAILS .

Menampilkan nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
ACMERR_NOTPOSSIBLE	Detail yang diminta tidak tersedia.
MMSYSERR_INVALFLAG	Setidaknya satu bendera tidak valid.
MMSYSERR_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.

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
Pustaka	Msacm32.lib
DLL	Msacm32.dll

Lihat juga

Fungsi Pemadatan Audio

Pengelola Pemadatan Audio

Bagikan melalui