CreateAudioMediaType-Funktion

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die CreateAudioMediaType-Funktion initialisiert einen Medientyp aus einer WAVEFORMATEX-Struktur .

Syntax

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

Parameter

pwfx: Zeiger auf die angegebene WAVEFORMATEX-Struktur .
Pmt: Zeiger auf die zu initialisierende AM_MEDIA_TYPE Struktur.
bSetFormat: Flag, das angibt, ob der Formatblock initialisiert werden soll. Geben Sie true an, um sie zu initialisieren, oder andernfalls FALSE .

Rückgabewert

Gibt E_OUTOFMEMORY zurück, wenn arbeitsspeicher nicht für die Formatdaten zugewiesen werden konnte. S_OK anders.

Bemerkungen

Wenn der bSetFormat-ParameterTRUE ist, weist die -Methode den Arbeitsspeicher für den Formatblock zu. Wenn der pmt-Parameter bereits einen zugeordneten Formatblock enthält, tritt ein Speicherverlust auf. Um einen Speicherverlust zu vermeiden, rufen Sie FreeMediaType auf, bevor Sie diese Funktion aufrufen. Nachdem die Methode zurückgegeben wurde, rufen Sie FreeMediaType erneut auf, um den Formatblock freizugeben.

Anforderungen

Anforderung	Wert
Header	Mtype.h (streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

Medientypfunktionen

Freigeben über