Compartilhar via

Método CMediaSample.GetMediaType

  • 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 GetMediaType método recuperará o tipo de mídia, se o tipo de mídia for diferente do exemplo anterior. Esse método implementa o método IMediaSample::GetMediaType .

Sintaxe

HRESULT GetMediaType(
   AM_MEDIA_TYPE **ppMediaType
);

Parâmetros

ppMediaType

Endereço de uma variável que recebe um ponteiro para uma estrutura AM_MEDIA_TYPE . Se o tipo de mídia não tiver sido alterado em relação ao exemplo anterior, *ppMediaType será definido como NULL.

Retornar valor

Retorna um dos valores HRESULT mostrados na tabela a seguir.

Código de retorno Descrição
S_FALSE
 O tipo de mídia não foi alterado em relação ao exemplo anterior.
S_OK
 Êxito.
E_OUTOFMEMORY
 Memória insuficiente.

Comentários

Quando terminar o tipo de mídia, libere o bloco de memória chamando a função de utilitário DeleteMediaType .

A variável de membro CMediaSample::m_pMediaType especifica o tipo de mídia. A variável de membro CMediaSample::m_dwFlags especifica se o tipo de mídia foi alterado.

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 CMediaSample