IMFSourceResolver::BeginCreateObjectFromURL-Methode (mfidl.h)

Artikel
08/24/2023

Startet eine asynchrone Anforderung zum Erstellen einer Medienquelle oder eines Bytestreams aus einer URL.

Syntax

HRESULT BeginCreateObjectFromURL(
  [in]  LPCWSTR          pwszURL,
  [in]  DWORD            dwFlags,
  [in]  IPropertyStore   *pProps,
  [out] IUnknown         **ppIUnknownCancelCookie,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState
);

Parameter

[in] pwszURL

Null-beendete Zeichenfolge, die die zu auflösende URL enthält.

[in] dwFlags

Bitweise OR von Flags. Weitere Informationen finden Sie unter Quelllöserflags.

[in] pProps

Zeiger auf die IPropertyStore-Schnittstelle eines Eigenschaftenspeichers. Die -Methode übergibt den Eigenschaftenspeicher an den Schemahandler oder byte-stream-Handler, der das Objekt erstellt. Der Handler kann den Eigenschaftenspeicher verwenden, um das Objekt zu konfigurieren. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie unter Konfigurieren einer Medienquelle.

[out] ppIUnknownCancelCookie

Empfängt einen IUnknown-Zeiger oder den Wert NULL. Wenn der Wert nicht NULL ist, können Sie den asynchronen Vorgang abbrechen, indem Sie diesen Zeiger an die IMFSourceResolver::CancelObjectCreation-Methode übergeben. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann NULL sein.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Der Aufrufer muss diese Schnittstelle implementieren.

[in] punkState

Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen aufzunehmen. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

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_SCHEME	Das URL-Schema wird nicht unterstützt.

Hinweise

Der dwFlags-Parameter muss entweder das MF_RESOLUTION_MEDIASOURCE-Flag oder das MF_RESOLUTION_BYTESTREAM-Flag enthalten, darf aber nicht beides enthalten.

Bei lokalen Dateien können Sie den Dateinamen im pwszURL-Parameter übergeben. das file: Schema ist nicht erforderlich.

Nach Abschluss des Vorgangs ruft der Quelllöser die IMFAsyncCallback::Invoke-Methode auf. Die Invoke-Methode sollte IMFSourceResolver::EndCreateObjectFromURL aufrufen, um einen Zeiger auf das objekt abzurufen, das erstellt wurde.

Die Verwendung des pProps-Parameters hängt von der Implementierung der Medienquelle ab.

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

Quelllöser

Freigeben über