Condividi tramite


Funzione MFCreateVideoRendererActivate (mfidl.h)

Crea un oggetto attivazione per il sink multimediale EVR (Enhanced Video Renderer).

Sintassi

HRESULT MFCreateVideoRendererActivate(
  [in]  HWND        hwndVideo,
  [out] IMFActivate **ppActivate
);

Parametri

[in] hwndVideo

Handle per la finestra in cui verrà visualizzato il video.

[out] ppActivate

Riceve un puntatore all'interfaccia IMFActivate . Usare questa interfaccia per creare l'EVR. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

La funzione restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.

Commenti

Per creare l'EVR, chiamare IMFActivate::ActivateObject sul puntatore IMFActivate recuperato. Se si usa la sessione multimediale, la sessione multimediale chiama automaticamente ActivateObject quando si accoda la topologia.

Per configurare EVR, impostare uno degli attributi seguenti sull'oggetto IMFActivate prima di chiamare ActivateObject.

Attributo Descrizione
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE Oggetto attivazione per un mixer personalizzato.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID CLSID per un mixer personalizzato.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS Flag per la creazione di un mixer personalizzato.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE Oggetto attivazione per un relatore personalizzato.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID CLSID per un relatore personalizzato.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS Flag per la creazione di un relatore personalizzato.
 

Quando viene chiamato IMFActivate::ActivateObject , gli oggetti attivazione impostano la finestra video su EVR chiamando IMFVideoDisplayControl::SetVideoPosition. Il passaggio di NULL per il parametro hwndVideo non è un errore, ma non verrà eseguito il rendering di alcun video a meno che L'EVR non abbia una finestra video valida.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfidl.h
Libreria Mf.lib
DLL Mf.dll

Vedi anche

Oggetti attivazione

Renderer video avanzato

Funzioni di Media Foundation