fungsi acmFilterDetailsA (msacm.h)

Artikel
08/24/2023

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

Sintaks

MMRESULT ACMAPI acmFilterDetailsA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  DWORD               fdwDetails
);

Parameter

had

Tangani ke driver ACM untuk mengkueri detail filter waveform-audio untuk tag filter. Jika parameter ini adalah 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 didefinisikan.

[ACMFILTERDETAILS] Struktur (./nf-msacm-acmfilterdetails.md) 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 memilikinya, 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 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 saat mengambil detail filter dengan bendera ini. Untuk informasi tentang anggota apa yang harus diinisialisasi sebelum memanggil fungsi ini, lihat struktur ACMFILTERDETAILS .

Nilai kembali

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan 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.

Keterangan

Catatan

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

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