CreateAudioMediaType-Funktion

[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

Siehe auch

Medientypfunktionen