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

Obtém um formato com 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.

Value	Meaning
0–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.

Value	Meaning
0–0xFFFFFFFE	O índice baseado em zero de um tipo de mídia
MF_SOURCE_READER_CURRENT_TYPE_INDEX 0xFFFFFFFF	O tipo de mídia nativa atual.

[out] ppMediaType

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

Valor de retorno

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código de retorno	Description
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.

Observações

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. Geralmente, 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.

Requirements

Requirement	Value
Cliente mínimo suportado	Suplemento windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
Header	mfreadwrite.h

Consulte também

IMFSourceReader

Leitor de origem