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