Compartir a través de


Método CBaseControlVideo.IsDefaultTargetRect

[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 IsDefaultTargetRect método determina si el representador usa el rectángulo de destino predeterminado (virtual puro).

Sintaxis

virtual HRESULT IsDefaultTargetRect() = 0;

Parámetros

Este método no tiene parámetros.

Valor devuelto

Devuelve S_OK si el representador usa el destino predeterminado; de lo contrario, devuelve S_FALSE.

Observaciones

Esta función miembro debe implementarse en la clase derivada. La llama la función miembro CBaseControlVideo::IsUsingDefaultDestination .

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

// Return S_OK if using the default target; otherwise, S_FALSE.
HRESULT CVideoText::IsDefaultTargetRect()
{
    RECT TargetRect;

    VIDEOINFO *pVideoInfo = (VIDEOINFO *) m_pRenderer->m_mtIn.Format();
    BITMAPINFOHEADER *pHeader = HEADER(pVideoInfo);
    m_pRenderer->m_DrawImage.GetTargetRect(&TargetRect);

    // Check the destination that matches the initial client area.

    if (TargetRect.left != 0 || TargetRect.top != 0 ||
            TargetRect.right != m_Size.cx ||
                TargetRect.bottom != m_Size.cy) {
                    return S_FALSE;
    }
    return S_OK;
}

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 . El m_mtIn miembro de datos, también definido en la clase derivada, contiene un objeto CMediaType con el tipo de medio del pin de entrada.

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)