Metodo IMFMediaEngine::Load (mfmediaengine.h)

Carica l'origine multimediale corrente.

Sintassi

HRESULT Load();

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Lo scopo principale di questo metodo è ricaricare un elenco di elementi di origine dopo l'aggiornamento dell'elenco. Per altre informazioni, vedere SetSourceElements. In caso contrario, la chiamata di questo metodo non è generalmente necessaria. Per caricare una nuova origine multimediale, chiamare IMFMediaEngine::SetSource o FMMediaEngine::SetSourceElements.

Il metodo Load richiama in modo esplicito l'algoritmo di caricamento delle risorse multimediali del motore multimediale. Prima di chiamare questo metodo, è necessario impostare la risorsa multimediale chiamando FMMediaEngine::SetSource o FMMediaEngine::SetSourceElements.

Questo metodo completa in modo asincrono. All'avvio dell'operazione di caricamento , il motore multimediale invia un evento MF_MEDIA_ENGINE_EVENT_LOADSTART . Se non si verificano errori durante l'operazione di caricamento , vengono generati diversi altri eventi, inclusi i seguenti.

  • MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
  • MF_MEDIA_ENGINE_EVENT_LOADEDDATA
  • MF_MEDIA_ENGINE_EVENT_CANPLAY
  • MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
Se il motore multimediale non è in grado di caricare il file, il motore multimediale invia un evento MF_MEDIA_ENGINE_EVENT_ERROR .

Per altre informazioni sulla gestione degli eventi nel motore multimediale, vedere FMMediaEngineNotify.

Questo metodo corrisponde al metodo di caricamento dell'interfaccia HTMLMediaElement in HTML5 .

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfmediaengine.h

Vedi anche

IMFMediaEngine