IMFMediaEngine::Load-Methode (mfmediaengine.h)
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
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 |