Struktur ACMFORMATDETAILS (msacm.h)

Artikel
24/08/2023

Struktur ACMFORMATDETAILS merinci format waveform-audio untuk tag format tertentu untuk driver ACM.

Sintaks

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

Anggota

cbStruct

Ukuran, dalam byte, dari struktur ACMFORMATDETAILS . Anggota ini harus diinisialisasi sebelum aplikasi memanggil fungsi acmFormatDetails atau acmFormatEnum . Ukuran yang ditentukan oleh anggota ini harus cukup besar untuk memuat struktur ACMFORMATDETAILS dasar. Ketika fungsi acmFormatDetails kembali, anggota ini berisi ukuran aktual informasi yang dikembalikan. Informasi yang dikembalikan tidak akan pernah melebihi ukuran yang diminta.

dwFormatIndex

Indeks format untuk mengambil detailnya. Indeks berkisar dari nol hingga satu kurang dari jumlah format standar yang didukung oleh driver ACM untuk tag format. Jumlah format standar yang didukung oleh driver untuk tag format terkandung dalam struktur ACMFORMATTAGDETAILS . Anggota dwFormatIndex hanya digunakan ketika aplikasi meminta detail format standar tentang driver menurut indeks; jika tidak, anggota ini harus nol. Selain itu, anggota ini akan diatur ke nol oleh ACM ketika aplikasi meminta detail tentang format; dengan kata lain, anggota ini hanya digunakan untuk input dan tidak pernah dikembalikan oleh ACM atau driver ACM.

dwFormatTag

Tag format waveform-audio yang dijelaskan struktur ACMFORMATDETAILS . Anggota ini digunakan untuk input untuk bendera kueri ACM_FORMATDETAILSF_INDEX. Untuk bendera kueri ACM_FORMATDETAILSF_FORMAT, anggota ini harus diinisialisasi ke tag format yang sama seperti yang ditentukan anggota pwfx . Jika panggilan ke fungsi acmFormatDetails berhasil, anggota ini selalu dikembalikan. Anggota ini harus diatur ke WAVE_FORMAT_UNKNOWN untuk semua bendera kueri lainnya.

fdwSupport

Bendera dukungan driver khusus untuk format yang ditentukan. Bendera ini identik dengan struktur ACMDRIVERDETAILS . Anggota ini dapat menjadi kombinasi dari nilai berikut dan menunjukkan operasi mana yang didukung driver untuk tag format:

Nama	Deskripsi
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Driver mendukung konversi asinkron dengan tag format yang ditentukan.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Driver mendukung konversi antara dua tag format berbeda untuk format yang ditentukan. Misalnya, jika driver mendukung pemadatan dari WAVE_FORMAT_PCM ke WAVE_FORMAT_ADPCM dengan format yang ditentukan, bendera ini diatur.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Driver mendukung konversi antara dua format berbeda dari tag format yang sama saat menggunakan format yang ditentukan. Misalnya, jika driver mendukung pengambilan sampel ulang WAVE_FORMAT_PCM ke format yang ditentukan, bendera ini diatur.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Driver mendukung filter (yang memodifikasi data tanpa mengubah atribut format apa pun) dengan format yang ditentukan. Misalnya, jika driver mendukung operasi volume atau gema pada WAVE_FORMAT_PCM, bendera ini diatur.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Driver mendukung input perangkat keras dan/atau output dari format yang ditentukan melalui perangkat waveform-audio. Aplikasi harus menggunakan acmMetrics dengan indeks metrik ACM_METRIC_HARDWARE_WAVE_INPUT dan ACM_METRIC_HARDWARE_WAVE_OUTPUT untuk mendapatkan pengidentifikasi perangkat waveform-audio yang terkait dengan driver ACM pendukung.

pwfx

Penunjuk ke struktur WAVEFORMATEX yang akan menerima detail format. Struktur ini tidak memerlukan inisialisasi oleh aplikasi kecuali bendera ACM_FORMATDETAILSF_FORMAT ditentukan dalam fungsi acmFormatDetails . Dalam hal ini, anggota wFormatTag dari struktur WAVEFORMATEX harus sama dengan dwFormatTag dari struktur ACMFORMATDETAILS .

cbwfx

Ukuran, dalam byte, tersedia untuk pwfx untuk menerima detail format. Fungsi acmMetrics dan acmFormatTagDetails dapat digunakan untuk menentukan ukuran maksimum yang diperlukan untuk format apa pun yang tersedia untuk driver yang ditentukan (atau untuk semua driver ACM yang diinstal).

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

String yang menjelaskan format untuk jenis dwFormatTag . Jika fungsi acmFormatDetails berhasil, string ini selalu dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	msacm.h