fungsi acmFormatDetails (msacm.h)

Artikel
08/24/2023

Fungsi acmFormatDetails meminta ACM untuk detail format untuk tag format waveform-audio tertentu.

Sintaks

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

Parameter

had

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

pafd

Penunjuk ke struktur ACMFORMATDETAILS untuk berisi detail format untuk tag format yang diberikan.

fdwDetails

Bendera untuk mendapatkan detail tag format waveform-audio. Nilai berikut ditentukan.

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

Nilai	Makna
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Indeks format untuk tag format diberikan dalam anggota dwFormatIndex dari struktur ACMFORMATDETAILS . Detail format akan dikembalikan dalam struktur yang ditentukan oleh pafd. Indeks berkisar dari nol hingga satu kurang dari anggota cStandardFormats yang dikembalikan dalam struktur ACMFORMATTAGDETAILS untuk tag format. Aplikasi harus menentukan handel driver untuk dimiliki saat mengambil detail format dengan bendera ini. Untuk informasi tentang anggota mana yang harus diinisialisasi sebelum memanggil fungsi ini, lihat struktur ACMFORMATDETAILS .

Nilai

Makna

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Indeks format untuk tag format diberikan dalam anggota dwFormatIndex dari struktur ACMFORMATDETAILS . Detail format akan dikembalikan dalam struktur yang ditentukan oleh pafd. Indeks berkisar dari nol hingga satu kurang dari anggota cStandardFormats yang dikembalikan dalam struktur ACMFORMATTAGDETAILS untuk tag format. Aplikasi harus menentukan handel driver untuk dimiliki saat mengambil detail format dengan bendera ini. Untuk informasi tentang anggota mana yang harus diinisialisasi sebelum memanggil fungsi ini, lihat struktur ACMFORMATDETAILS .

Nilai kembali

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

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 Pemadatan Audio

Bagikan melalui