Método CBasePin.SetMediaType

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 SetMediaType método define o tipo de mídia para a conexão.

Sintaxe

virtual HRESULT SetMediaType(
   const CMediaType *pmt
);

Parâmetros

Pgto

Ponteiro para um objeto CMediaType que especifica o tipo de mídia.

Retornar valor

Returns S_OK.

Comentários

Esse método estabelece o formato para uma conexão de pino. Antes de chamar esse método, o pin chama o método CBasePin::CheckMediaType para determinar se o tipo de mídia é aceitável. Portanto, o parâmetro pmt é considerado um tipo de mídia aceitável.

Na classe base, esse método define a variável de membro CBasePin::m_mt e retorna S_OK. Uma classe derivada poderá substituir esse método se exigir notificação quando o tipo de mídia estiver definido.

Requisitos

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

Confira também

Classe CBasePin