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

  • Artigo

Define o tipo de mídia para um fluxo.

Esse tipo de mídia define esse formato que o Leitor de Origem produz como saída. Ele pode ser diferente do formato nativo fornecido pela fonte de mídia. Confira Comentários para obter mais informações.

Sintaxe

HRESULT SetCurrentMediaType(
  [in]      DWORD        dwStreamIndex,
  [in, out] DWORD        *pdwReserved,
  [in]      IMFMediaType *pMediaType
);

Parâmetros

[in] dwStreamIndex

O fluxo a ser configurado. 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, out] pdwReserved

Reservado. Defina como NULL.

[in] pMediaType

Um ponteiro para a interface IMFMediaType do tipo de mídia.

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_INVALIDMEDIATYPE
 Pelo menos um decodificador foi encontrado para o tipo de fluxo nativo, mas o tipo especificado por pMediaType foi rejeitado.
MF_E_INVALIDREQUEST
 Uma ou mais solicitações de exemplo ainda estão pendentes.
MF_E_INVALIDSTREAMNUMBER
 O parâmetro dwStreamIndex é inválido.
MF_E_TOPO_CODEC_NOT_FOUND
 Não foi possível encontrar um decodificador para o tipo de fluxo nativo.

Comentários

Para cada fluxo, você pode definir o tipo de mídia como qualquer um dos seguintes:

  • Um dos tipos nativos oferecidos pela fonte de mídia. Para enumerar os tipos nativos, chame IMFSourceReader::GetNativeMediaType.
  • Se o tipo de mídia nativa for compactado, você poderá especificar um formato descompactado correspondente. O Leitor de Origem pesquisará um decodificador que pode decodificar do formato nativo para o formato descompactado especificado.
O suporte à reempasagem de áudio foi adicionado ao leitor de origem com Windows 8. Em versões do Windows anteriores ao Windows 8, o leitor de origem não dá suporte à resampação de áudio. Se você precisar reexamploar o áudio em versões do Windows anteriores a Windows 8, poderá usar o DSP do Repositório de Áudio.

Se você definir o atributo MF_SOURCE_READER_ENABLE_VIDEO_PROCESSING como TRUE ao criar o Leitor de Origem, o Leitor de Origem converterá o vídeo YUV em RGB-32. Essa conversão não é otimizada para reprodução de vídeo em tempo real.

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