Compartir a través de


Método CBaseControlVideo.GetTargetRect

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetTargetRect método recupera el rectángulo de destino. Se trata de una función miembro auxiliar interna.

Sintaxis

virtual HRESULT GetTargetRect(
   RECT *pTargetRect
) = 0;

Parámetros

pTargetRect

Puntero al rectángulo de destino.

Valor devuelto

Devuelve un valor HRESULT .

Observaciones

Esta función miembro se debe invalidar en la clase derivada para devolver el rectángulo de destino mantenido por el representador de vídeo. Se llama desde las siguientes funciones miembro de CBaseControlVideo .

En el ejemplo siguiente se muestra una implementación de esta función en una clase derivada.

// Return the current destination rectangle.
HRESULT CVideoText::GetTargetRect(RECT *pTargetRect)
{
    ASSERT(pTargetRect);
    m_pRenderer->m_DrawImage.GetTargetRect(pTargetRect);
    return NOERROR;
}

En este ejemplo, CVideoText es una clase derivada de CBaseControlVideo, m_pRenderer contiene un objeto de una clase derivada de CBaseVideoRenderer y el miembro de datos m_DrawImage, definido en la clase derivada, contiene un objeto CDrawImage .

Requisitos

Requisito Value
Encabezado
Ctlutil.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseControlVideo (clase)