fungsi acmFormatSuggest (msacm.h)

Artikel
03/15/2023

Fungsi acmFormatSuggest meminta ACM atau driver ACM tertentu untuk menyarankan format tujuan untuk format sumber yang disediakan. Misalnya, aplikasi dapat menggunakan fungsi ini untuk menentukan satu atau beberapa format PCM yang valid di mana format terkompresi dapat didekompresi.

Sintaks

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Parameter

had

Tangani ke instans terbuka driver untuk mengkueri format tujuan yang disarankan. Jika parameter ini NULL, ACM mencoba menemukan driver terbaik untuk menyarankan format tujuan.

pwfxSrc

Penunjuk ke struktur WAVEFORMATEX yang mengidentifikasi format sumber yang format tujuannya akan disarankan oleh ACM atau driver yang ditentukan.

pwfxDst

Penunjuk ke struktur WAVEFORMATEX yang akan menerima format tujuan yang disarankan untuk format pwfxSrc . Tergantung pada parameter fdwSuggest , beberapa anggota struktur yang diarahkan oleh pwfxDst mungkin memerlukan inisialisasi.

cbwfxDst

Ukuran, dalam byte, tersedia untuk format tujuan. 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).

fdwSuggest

Bendera untuk mencocokkan format tujuan yang diinginkan. Nilai berikut ditentukan.

Nilai	Makna
ACM_FORMATSUGGESTF_NCHANNELS	Anggota nChannels dari struktur yang diarahkan oleh pwfxDst valid. ACM akan meminta driver terinstal yang dapat diterima yang dapat menyarankan format tujuan yang cocok dengan nChannels atau gagal.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	Anggota nSamplesPerSec dari struktur yang diarahkan oleh pwfxDst valid. ACM akan meminta driver terinstal yang dapat diterima yang dapat menyarankan format tujuan yang cocok dengan nSamplesPerSec atau gagal.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	Anggota wBitsPerSample dari struktur yang diarahkan oleh pwfxDst valid. ACM akan meminta driver terinstal yang dapat diterima yang dapat menyarankan format tujuan yang cocok dengan wBitsPerSample atau gagal.
ACM_FORMATSUGGESTF_WFORMATTAG	Anggota wFormatTag dari struktur yang diarahkan oleh pwfxDst valid. ACM akan meminta driver terinstal yang dapat diterima yang dapat menyarankan format tujuan yang cocok dengan wFormatTag atau gagal.

Menampilkan nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMSYSERR_INVALFLAG	Setidaknya satu bendera tidak valid.
MMSYSERR_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.

Persyaratan


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