Método IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

  • Artigo

Obtém um formato que tem suporte nativo pela fonte de mídia.

Sintaxe

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Parâmetros

[in] dwStreamIndex

Especifica qual fluxo consultar. O valor pode ser qualquer um dos seguintes.

Valor Significado
0 a 0xFFFFFFFB
 O índice baseado em zero de um fluxo.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 O primeiro fluxo de vídeo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 O primeiro fluxo de áudio.

[in] dwMediaTypeIndex

Especifica qual tipo de mídia consultar. O valor pode ser qualquer um dos seguintes.

Valor Significado
0 a 0xFFFFFFFE
 O índice baseado em zero de um tipo de mídia
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
 O tipo de mídia nativo atual.

[out] ppMediaType

Recebe um ponteiro para a interface IMFMediaType . O chamador deve liberar a interface .

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_INVALIDSTREAMNUMBER
 O parâmetro dwStreamIndex é inválido.
MF_E_NO_MORE_TYPES
 O parâmetro dwMediaTypeIndex está fora do intervalo.

Comentários

Esse método consulta a fonte de mídia subjacente para seu formato de saída nativo. Potencialmente, cada fluxo de origem pode produzir mais de um formato de saída. Use o parâmetro dwMediaTypeIndex para percorrer os formatos disponíveis. Em geral, as fontes de arquivo oferecem apenas um formato por fluxo, mas os dispositivos de captura podem oferecer vários formatos.

O método retorna uma cópia do tipo de mídia, portanto, é seguro modificar o objeto recebido no parâmetro ppMediaType .

Para definir o tipo de saída para um fluxo, chame o método IMFSourceReader::SetCurrentMediaType .

Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Suplemento Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfreadwrite.h

Confira também

IMFSourceReader

Leitor de Origem