Método CBaseControlVideo.SetSourceRect

  • Artículo

[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 SetSourceRect método establece el rectángulo de vídeo de origen actual (virtual puro). Se trata de una función miembro interna a la que se llama cuando cambia el rectángulo de origen.

Sintaxis

virtual HRESULT SetSourceRect(
   RECT *pSourceRect
) = 0;

Parámetros

pSourceRect

Puntero al rectángulo de origen.

Valor devuelto

Devuelve un valor HRESULT .

Observaciones

Las clases derivadas deben invalidar esta función miembro para saber cuándo cambia el rectángulo de origen. Se llama desde las siguientes funciones miembro.

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

HRESULT CVideoText::SetSourceRect(RECT *pSourceRect)
{
    m_pRenderer->m_DrawImage.SetSourceRect(pSourceRect);
    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)