Fonction MFCreateVideoRendererActivate (mfidl.h)

Crée un objet d’activation pour le récepteur multimédia evr (Enhanced Video Renderer).

Syntaxe

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

Paramètres

[in] hwndVideo

Gérez la fenêtre dans laquelle la vidéo sera affichée.

[out] ppActivate

Reçoit un pointeur vers l’interface IMFActivate . Utilisez cette interface pour créer l’EVR. L’appelant doit libérer l’interface.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

Pour créer l’EVR, appelez IMFActivate ::ActivateObject sur le pointeur IMFActivate récupéré. (Si vous utilisez la session multimédia, la session multimédia appelle automatiquement ActivateObject lorsque vous mettez en file d’attente la topologie.)

Pour configurer l’EVR, définissez l’un des attributs suivants sur l’objet IMFActivate avant d’appeler ActivateObject.

Attribut	Description
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE	Objet d’activation pour un mélangeur personnalisé.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID	CLSID pour un mélangeur personnalisé.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS	Indicateurs pour la création d’un mélangeur personnalisé.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE	Objet d’activation pour un présentateur personnalisé.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID	CLSID pour un présentateur personnalisé.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS	Indicateurs pour la création d’un présentateur personnalisé.

 

Quand IMFActivate ::ActivateObject est appelé, les objets d’activation définissent la fenêtre vidéo sur l’EVR en appelant IMFVideoDisplayControl ::SetVideoPosition. Le passage de la valeur NULL pour le paramètre hwndVideo n’est pas une erreur, mais aucune vidéo ne sera rendue, sauf si l’EVR dispose d’une fenêtre vidéo valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mf.lib
DLL	Mf.dll

Voir aussi

Objets d’activation

Convertisseur vidéo amélioré

Fonctions Media Foundation