Método CTransformOutputPin.CheckMediaType

[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 CheckMediaType método determina se o pino aceita um tipo de mídia específico.

Sintaxe

HRESULT CheckMediaType(
   const CMediaType *mtIn
);

Parâmetros

mtIn

Ponteiro para um objeto CMediaType que contém o tipo de mídia proposto.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	O pino de entrada do filtro não está conectado.

Comentários

Esse método implementa o método CBasePin::CheckMediaType virtual puro. O método falhará se o pino de entrada do filtro não estiver conectado. Caso contrário, ele chamará o método CTransformFilter::CheckTransform do filtro, que também é virtual puro. A classe derivada do filtro deve implementar CheckTransform, que determina se o tipo de mídia de saída proposto é compatível com o tipo de mídia de entrada.

Requisitos

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