Compartilhar via


Método CBaseControlVideo.IsDefaultTargetRect

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O IsDefaultTargetRect método determina se o renderizador está usando o retângulo de destino padrão (virtual puro).

Sintaxe

virtual HRESULT IsDefaultTargetRect() = 0;

Parâmetros

Esse método não tem parâmetros.

Retornar valor

Retorna S_OK se o renderizador estiver usando o destino padrão; caso contrário, retornará S_FALSE.

Comentários

Essa função membro deve ser implementada na classe derivada. Ele é chamado pela função membro CBaseControlVideo::IsUsingDefaultDestination .

O exemplo a seguir demonstra uma implementação dessa função em uma classe 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;
}

Neste exemplo, CVideoText é uma classe derivada de CBaseControlVideo, m_pRenderer contém um objeto de uma classe derivada de CBaseVideoRenderer e o membro de dados m_DrawImage, definido na classe derivada, contém um objeto CDrawImage . O membro de dados m_mtIn, também definido na classe derivada, contém um objeto CMediaType com o tipo de mídia do pin de entrada.

Requisitos

Requisito Valor
parâmetro
Ctlutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseControlVideo