Função MFCreateSourceReaderFromMediaSource (mfreadwrite.h)

Cria o leitor de origem de uma fonte de mídia.

Sintaxe

HRESULT MFCreateSourceReaderFromMediaSource(
  [in]  IMFMediaSource  *pMediaSource,
  [in]  IMFAttributes   *pAttributes,
  [out] IMFSourceReader **ppSourceReader
);

Parâmetros

[in] pMediaSource

Um ponteiro para a interface IMFMediaSource de uma fonte de mídia.

[in] pAttributes

Ponteiro para a interface IMFAttributes . Você pode usar esse parâmetro para configurar o leitor de origem. Para obter mais informações, consulte Atributos do Leitor de Origem. Esse parâmetro pode ser NULL.

[out] ppSourceReader

Recebe um ponteiro para a interface IMFSourceReader . 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.

Observações

Chame CoInitialize(Ex) e MFStartup antes de chamar essa função.

Por padrão, quando o aplicativo libera o leitor de origem, o leitor de origem desliga a fonte de mídia chamando IMFMediaSource::Shutdown na fonte de mídia. Nesse ponto, o aplicativo não pode mais usar a fonte de mídia.

Para alterar esse comportamento padrão, defina o atributo MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN no parâmetro pAttributes . Se esse atributo for TRUE, o aplicativo será responsável por desligar a fonte de mídia.

Ao usar o Leitor de Origem, não chame nenhum dos seguintes métodos na fonte de mídia:

• IMFMediaSource::P ause
• IMFMediaSource::Start
• IMFMediaSource::Stop
• Todos os métodos IMFMediaEventGenerator

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

Requirements

Consulte também

Funções do Media Foundation

Leitor de origem