IMFMediaEngine::SetSource-Methode (mfmediaengine.h)

  • Artikel

Legt die URL einer Medienressource fest.

Syntax

HRESULT SetSource(
  [in] BSTR pUrl
);

Parameter

[in] pUrl

Die URL der Medienressource.

Rückgabewert

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

Hinweise

Diese Methode entspricht dem Festlegen des src-Attributs der HTMLMediaElement-Schnittstelle in HTML5.

Die von dieser Methode angegebene URL hat Vorrang vor Medienressourcen, die in der IMFMediaEngine::SetSourceElements-Methode angegeben sind. Um die URL zu laden, rufen Sie IMFMediaEngine::Load auf.

Diese Methode lädt die URL asynchron. Wenn der Vorgang gestartet wird, sendet die Medien-Engine ein MF_MEDIA_ENGINE_EVENT_LOADSTART-Ereignis . Wenn während des Ladevorgangs keine Fehler auftreten, werden mehrere andere Ereignisse generiert, einschließlich der folgenden.

  • MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
  • MF_MEDIA_ENGINE_EVENT_LOADEDDATA
  • MF_MEDIA_ENGINE_EVENT_CANPLAY
  • MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
Wenn die Medien-Engine die URL nicht laden kann, sendet die Medien-Engine ein MF_MEDIA_ENGINE_EVENT_ERROR-Ereignis .

Weitere Informationen zur Ereignisbehandlung in der Medien-Engine finden Sie unter IMFMediaEngineNotify.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfmediaengine.h

Weitere Informationen

IMFMediaEngine