IMFMediaEngine::Load-Methode (mfmediaengine.h)

  • Artikel

Lädt die aktuelle Medienquelle.

Syntax

HRESULT Load();

Rückgabewert

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

Hinweise

Der Standard Zweck dieser Methode besteht darin, nach dem Aktualisieren der Liste eine Liste der Quellelemente neu zu laden. Weitere Informationen finden Sie unter SetSourceElements. Andernfalls ist der Aufruf dieser Methode in der Regel nicht erforderlich. Um eine neue Medienquelle zu laden, rufen Sie IMFMediaEngine::SetSource oder IMFMediaEngine::SetSourceElements auf.

Die Load-Methode ruft explizit den Medienressourcenladealgorithmus der Medien-Engine auf. Vor dem Aufrufen dieser Methode müssen Sie die Medienressource festlegen, indem Sie IMFMediaEngine::SetSource oder IMFMediaEngine::SetSourceElements aufrufen.

Diese Methode wird asynchron abgeschlossen. Wenn der Ladevorgang 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 Datei 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.

Diese Methode entspricht der load-Methode der HTMLMediaElement-Schnittstelle in HTML5.

Anforderungen

Anforderung Wert
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