Fungsi CreateAudioMediaType

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Fungsi CreateAudioMediaType menginisialisasi jenis media dari struktur WAVEFORMATEX .

Sintaks

HRESULT STDAPI CreateAudioMediaType(
   const WAVEFORMATEX  *pwfx,
         AM_MEDIA_TYPE *pmt,
         BOOL          bSetFormat
);

Parameter

pwfx: Pointer ke struktur WAVEFORMATEX yang disediakan.
Pmt: Arahkan ke struktur AM_MEDIA_TYPE untuk menginisialisasi.
bSetFormat: Bendera yang menunjukkan apakah akan menginisialisasi blok format. Tentukan TRUE untuk menginisialisasinya, atau FALSE jika tidak.

Mengembalikan nilai

Mengembalikan E_OUTOFMEMORY jika memori tidak dapat dialokasikan untuk data format; S_OK sebaliknya.

Keterangan

Jika parameter bSetFormatTRUE, metode mengalokasikan memori untuk blok format. Jika parameter pmt sudah berisi blok format yang dialokasikan, kebocoran memori akan terjadi. Untuk menghindari kebocoran memori, panggil FreeMediaType sebelum memanggil fungsi ini. Setelah metode kembali, panggil FreeMediaType lagi untuk membebaskan blok format.

Persyaratan

Persyaratan	Nilai
Header	Mtype.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Fungsi Jenis Media

Bagikan melalui