IMFMediaEngine::SetSourceElements-Methode (mfmediaengine.h)

Legt eine Liste der Medienquellen fest.

Syntax

HRESULT SetSourceElements(
  [in] IMFMediaEngineSrcElements *pSrcElements
);

Parameter

[in] pSrcElements

Ein Zeiger auf die IMFMediaEngineSrcElements-Schnittstelle . Der Aufrufer muss diese Schnittstelle implementieren.

Rückgabewert

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

Hinweise

Diese Methode entspricht dem Hinzufügen einer Liste von Quellelementen zu einem Medienelement in HTML5.

Die Medien-Engine versucht, jedes Element in der pSrcElements-Liste zu laden, bis ein Element gefunden wird, das erfolgreich geladen wird. Nachdem diese Methode aufgerufen wurde, kann die Anwendung die IMFMediaEngineSrcElements-Schnittstelle verwenden, um die Liste jederzeit zu aktualisieren. Um die Liste neu zu laden, rufen Sie IMFMediaEngine::Load auf.

Diese Methode wird asynchron abgeschlossen. Wenn der Vorgang gestartet wird, sendet die Media 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 keine URL laden kann, sendet sie ein MF_MEDIA_ENGINE_EVENT_ERROR-Ereignis .

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

Wenn die Anwendung auch IMFMediaEngine::SetSource aufruft, hat die an SetSource übergebene URL Vorrang vor der Liste, die SetSourceElements zugewiesen wurde.

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