Méthode CBaseControlVideo.SetTargetRect

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La SetTargetRect méthode définit le rectangle cible actuel (virtuel pur). Il s’agit d’une fonction membre interne qui est appelée lorsque le rectangle de destination change.

Syntaxe

virtual HRESULT SetTargetRect(
   RECT *pTargetRect
) = 0;

Paramètres

pTargetRect

Pointeur vers le rectangle de destination.

Valeur renvoyée

Retourne une valeur HRESULT .

Notes

Les classes dérivées doivent remplacer ce paramètre pour savoir quand le rectangle de destination change. Il est appelé à partir des fonctions membres suivantes.

L’exemple suivant illustre une implémentation de cette fonction dans une classe dérivée.

HRESULT CVideoText::SetTargetRect(RECT *pTargetRect)
{
    m_pRenderer->m_DrawImage.SetTargetRect(pTargetRect);
    return NOERROR;
}

Dans cet exemple, CVideoText est une classe dérivée de CBaseControlVideo, m_pRenderer contient un objet d’une classe dérivée de CBaseVideoRenderer, et le membre de données m_DrawImage, défini dans la classe dérivée, contient un objet CDrawImage .

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBaseControlVideo, classe