Compartilhar via


Método CBaseControlVideo.SetDefaultTargetRect

[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 SetDefaultTargetRect método define o retângulo de vídeo de destino padrão (virtual puro). Essa é uma função membro interna que é chamada quando o retângulo de origem é redefinido.

Sintaxe

virtual HRESULT SetDefaultTargetRect() = 0;

Parâmetros

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

Retornar valor

Retorna um valor HRESULT .

Comentários

Classes derivadas devem substituir isso para redefinir o retângulo de vídeo de destino. Ele é chamado da função membro CBaseControlVideo::SetDefaultDestinationPosition .

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

// This is called when you reset the default target rectangle.
HRESULT CVideoText::SetDefaultTargetRect()
{
    VIDEOINFO *pVideoInfo = (VIDEOINFO *) m_pRenderer->m_mtIn.Format();
    BITMAPINFOHEADER *pHeader = HEADER(pVideoInfo);
    RECT TargetRect = {0,0,m_Size.cx,m_Size.cy};
    m_pRenderer->m_DrawImage.SetTargetRect(&TargetRect);
    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 . O m_mtIn membro de dados, também definido na classe derivada, contém um objeto CMediaType com o tipo de mídia do pino 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