fungsi acmFormatDetailsW (msacm.h)

Artikel
11/20/2024

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

Sintaksis

MMRESULT ACMAPI acmFormatDetailsW(
  HACMDRIVER          had,
  LPACMFORMATDETAILSW 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 (./nf-msacm-acmformatdetails.md) diberikan dan detail yang tersisa harus dikembalikan. dwFormatTag anggota 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 memiliki, detail tentang format akan dikembalikan untuk driver tersebut. Jika aplikasi menentukan NULL untuk memiliki, ACM menemukan driver pertama yang dapat diterima untuk mengembalikan detailnya.

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

Nilai

Arti

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

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

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 ACMFORMATDETAILS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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