Método CBaseControlVideo.IsDefaultSourceRect

[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 IsDefaultSourceRect método determina se o renderizador está usando o retângulo de origem padrão (virtual puro).

Sintaxe

virtual HRESULT IsDefaultSourceRect() = 0;

Parâmetros

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

Retornar valor

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

Comentários

Essa função membro deve ser implementada na classe derivada. Ela é chamada pela função membro CBaseControlVideo::IsUsingDefaultSource .

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

// Return S_OK if using the default source; otherwise, S_FALSE.
HRESULT CVideoText::IsDefaultSourceRect()
{
    RECT SourceRect;

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

    // Check the coordinates that match the video dimensions.

    if (SourceRect.left != 0 || SourceRect.top != 0 ||
            SourceRect.right != pHeader->biWidth ||
                SourceRect.bottom != pHeader->biHeight) {
                    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 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