Método CBaseControlVideo.GetTargetRect

  • Artigo

[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 GetTargetRect método recupera o retângulo de destino. Essa é uma função de membro auxiliar interna.

Sintaxe

virtual HRESULT GetTargetRect(
   RECT *pTargetRect
) = 0;

Parâmetros

pTargetRect

Ponteiro para o retângulo de destino.

Retornar valor

Retorna um valor HRESULT .

Comentários

Essa função membro deve ser substituída na classe derivada para retornar o retângulo de destino mantido pelo renderizador de vídeo. Ele é chamado das seguintes funções membro CBaseControlVideo .

O exemplo a seguir demonstra uma implementação dessa função em uma classe derivada.

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

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 .

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