fungsi acmFilterDetailsW (msacm.h)

Artikel
11/20/2024

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

Sintaksis

MMRESULT ACMAPI acmFilterDetailsW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW 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 (./nf-msacm-acmfilterdetails.md) diberikan dan detail yang tersisa harus dikembalikan. dwFilterTag anggota strukturACMFILTERDETAILS harus diinisialisasi ke tag filter yang sama pwfltr yang ditentukan. Jenis kueri ini dapat digunakan untuk mendapatkan deskripsi string dari struktur filter arbitrer. Jika aplikasi menentukan handel driver ACM untuk memiliki, detail tentang filter akan dikembalikan untuk driver tersebut. Jika aplikasi menentukan NULL untuk memiliki, ACM menemukan driver pertama yang dapat diterima untuk mengembalikan detailnya.

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

Nilai

Arti

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

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

Mengembalikan nilai

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

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

Komentar

Nota

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