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 |
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 |