MFCreateAudioMediaType-Funktion (mfapi.h)

  • Artikel

[Diese API wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein.]

Erstellt einen Audiomedientyp aus einer WAVEFORMATEX-Struktur .

Syntax

HRESULT MFCreateAudioMediaType(
  [in]  const WAVEFORMATEX *pAudioFormat,
  [out] IMFAudioMediaType  **ppIAudioMediaType
);

Parameter

[in] pAudioFormat

Zeiger auf eine WAVEFORMATEX-Struktur , die das Audioformat beschreibt.

[out] ppIAudioMediaType

Empfängt einen Zeiger auf die IMFAudioMediaType-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die IMFAudioMediaType-Schnittstelle ist veraltet, daher sollten Anwendungen die Verwendung dieser Funktion vermeiden. Gehen Sie wie folgt vor, um einen Medientyp aus einer WAVEFORMATEX-Struktur zu erstellen:

  1. Rufen Sie MFCreateMediaType auf. Diese Funktion gibt einen Zeiger auf die IMFMediaType-Schnittstelle zurück. Das zurückgegebene Medientypobjekt ist zunächst leer.
  2. Rufen Sie MFInitMediaTypeFromWaveFormatEx auf, um den Medientyp aus der WAVEFORMATEX-Struktur aufzufüllen .
Alternativ können Sie MFCreateMediaType aufrufen und dann die Medientypattribute direkt festlegen.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup vom Oktober 2006 für Windows XP Media Center Edition) installiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Audiomedientypen

Media Foundation-Funktionen

Medientypen