IMFSourceResolver::CreateObjectFromByteStream-Methode (mfidl.h)

  • Artikel

Erstellt eine Medienquelle aus einem Bytedatenstrom. Diese Methode ist synchron.

Syntax

HRESULT CreateObjectFromByteStream(
  [in]  IMFByteStream  *pByteStream,
  [in]  LPCWSTR        pwszURL,
  [in]  DWORD          dwFlags,
  [in]  IPropertyStore *pProps,
  [out] MF_OBJECT_TYPE *pObjectType,
  [out] IUnknown       **ppObject
);

Parameter

[in] pByteStream

Zeiger auf die IMFByteStream-Schnittstelle des Bytedatenstroms.

[in] pwszURL

Null-beendete Zeichenfolge, die die URL des Bytedatenstroms enthält. Die URL ist optional und kann NULL sein. Weitere Informationen finden Sie unter Hinweise.

[in] dwFlags

Bitweises OR von Flags. Weitere Informationen finden Sie unter Quellkonfliktlöserflags.

[in] pProps

Zeiger auf die IPropertyStore-Schnittstelle eines Eigenschaftenspeichers. Die -Methode übergibt den Eigenschaftenspeicher an den Bytestreamhandler. Der Bytestreamhandler kann den Eigenschaftenspeicher verwenden, um die Medienquelle zu konfigurieren. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie unter Konfigurieren einer Medienquelle.

[out] pObjectType

Empfängt einen Member der MF_OBJECT_TYPE-Enumeration , der den Typ des erstellten Objekts angibt.

[out] ppObject

Empfängt einen Zeiger auf die IUnknown-Schnittstelle der Medienquelle. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS
 Der dwFlags-Parameter enthält sich gegenseitig ausschließende Flags.
MF_E_UNSUPPORTED_BYTESTREAM_TYPE
 Dieser Bytedatenstrom wird nicht unterstützt.

Hinweise

Der dwFlags-Parameter muss das MF_RESOLUTION_MEDIASOURCE-Flag enthalten und darf nicht das MF_RESOLUTION_BYTESTREAM-Flag enthalten.

Der Quellrelöser versucht, einen oder mehrere Bytestreamhandler für den Bytedatenstrom zu finden, basierend auf der Dateinamenerweiterung der URL oder dem MIME-Typ des Bytedatenstroms (oder beides). Die URL wird im optionalen pwszURL-Parameter angegeben, und der MIME-Typ kann im attribut MF_BYTESTREAM_CONTENT_TYPE für den Bytedatenstrom angegeben werden. Byte-Stream-Handler werden nach Dateinamenerweiterung oder MIME-Typ oder beidem registriert, wie unter Schemahandler und Byte-Stream Handler beschrieben. Der Aufrufer sollte mindestens einen dieser Werte angeben (beides, wenn möglich):

  • Geben Sie die URL im parameter pwszURL an.
  • Geben Sie den MIME-Typ an, indem Sie das attribut MF_BYTESTREAM_CONTENT_TYPE für den Bytedatenstrom festlegen. (Dieses Attribut kann bereits festgelegt sein, wenn Sie den Bytedatenstrom erstellen, je nachdem, wie der Bytedatenstrom erstellt wurde.)
Hinweis Diese Methode kann nicht remote aufgerufen werden.
 

Anforderungen

   
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 Mfuuid.lib

Weitere Informationen

IMFSourceResolver

Quellkonfliktlöser