MFCreateStreamDescriptor-Funktion (mfidl.h)

  • Artikel

Erstellt einen Streamdeskriptor.

Syntax

HRESULT MFCreateStreamDescriptor(
  DWORD               dwStreamIdentifier,
  DWORD               cMediaTypes,
  IMFMediaType        **apMediaTypes,
  IMFStreamDescriptor **ppDescriptor
);

Parameter

dwStreamIdentifier

Stream Bezeichner.

cMediaTypes

Anzahl der Elemente im apMediaTypes-Array .

apMediaTypes

Zeiger auf ein Array von IMFMediaType-Schnittstellenzeigern . Diese Zeiger werden verwendet, um den Medientyphandler für den Streamdeskriptor zu initialisieren.

ppDescriptor

Empfängt einen Zeiger auf die IMFStreamDescriptor-Schnittstelle des neuen Streamdeskriptors. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

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

Hinweise

Wenn Sie eine benutzerdefinierte Medienquelle schreiben, können Sie diese Funktion verwenden, um Streamdeskriptoren für die Quelle zu erstellen. Diese Funktion erstellt automatisch den Medientyphandler für den Streamdeskriptor und initialisiert ihn mit der Liste der Typen, die in apMediaTypes angegeben sind. Die Funktion legt jedoch nicht den aktuellen Medientyp für den Handler fest. Um den Typ festzulegen, rufen Sie IMFMediaTypeHandler::SetCurrentMediaType auf.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Komponenten des Windows Media Format 11 SDK 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 für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen

Präsentationsdeskriptoren