IMFVideoMixerControl::SetStreamOutputRect, méthode (evr.h)
Définit la position d’un flux vidéo dans le rectangle de composition.
Syntaxe
HRESULT SetStreamOutputRect(
[in] DWORD dwStreamID,
[in] const MFVideoNormalizedRect *pnrcOutput
);
Paramètres
[in] dwStreamID
Identificateur du flux. Pour le récepteur multimédia EVR, l’identificateur de flux est défini lorsque la méthode IMFMediaSink::AddStreamSink est appelée. Pour le filtre DirectShow EVR, l’identificateur de flux correspond à l’index d’épingle. Le flux de référence est toujours de flux 0.
[in] pnrcOutput
Pointeur vers une structure MFVideoNormalizedRect qui définit le rectangle englobant du flux vidéo.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
Les coordonnées du rectangle englobant donné dans pnrcOutput ne sont pas valides. |
|
Identificateur de flux non valide. |
Notes
Le mélangeur dessine chaque flux vidéo dans un rectangle englobant spécifié par rapport à l’image vidéo finale. Ce rectangle englobant est donné en coordonnées normalisées . Pour plus d’informations, consultez la structure MFVideoNormalizedRect .
Les coordonnées du rectangle englobant doivent se trouver dans la plage [0.0, 1.0]. En outre, les coordonnées X et Y du coin supérieur gauche ne peuvent pas dépasser les coordonnées X et Y du coin inférieur droit. En d’autres termes, le rectangle englobant doit s’adapter entièrement au rectangle de composition et ne peut pas être retourné verticalement ou horizontalement.
Le diagramme suivant montre comment l’EVR mélange les sous-flux.
Le rectangle de sortie du flux est spécifié en appelant SetStreamOutputRect. Le rectangle source est spécifié en appelant IMFVideoDisplayControl::SetVideoPosition. Le mélangeur applique d’abord le rectangle de sortie, lorsqu’il mélange les flux dans un rectangle englobant unique. Ce rectangle englobant est appelé espace de composition. Ensuite, le présentateur applique le rectangle source à l’image composite.
Configuration requise
| 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 | evr.h |
| Bibliothèque | Strmiids.lib |