Méthode CBaseControlVideo.GetTargetRect

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 GetTargetRect méthode récupère le rectangle de destination. Il s’agit d’une fonction membre d’assistance interne.

Syntaxe

virtual HRESULT GetTargetRect(
   RECT *pTargetRect
) = 0;

Paramètres

pTargetRect

Pointeur vers le rectangle de destination.

Valeur renvoyée

Retourne une valeur HRESULT .

Notes

Cette fonction membre doit être remplacée dans la classe dérivée pour renvoyer le rectangle cible tenu par le convertisseur vidéo. Il est appelé à partir des fonctions membres CBaseControlVideo suivantes.

• CBaseControlVideo::GetDestinationPosition
• CBaseControlVideo::p ut_DestinationLeft
• CBaseControlVideo::get_DestinationLeft
• CBaseControlVideo::p ut_DestinationWidth
• CBaseControlVideo::get_DestinationWidth
• CBaseControlVideo::p ut_DestinationTop
• CBaseControlVideo::get_DestinationTop
• CBaseControlVideo::p ut_DestinationHeight
• CBaseControlVideo::get_DestinationHeight

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

// Return the current destination rectangle.
HRESULT CVideoText::GetTargetRect(RECT *pTargetRect)
{
    ASSERT(pTargetRect);
    m_pRenderer->m_DrawImage.GetTargetRect(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

Voir aussi

Classe CBaseControlVideo