Compartilhar via


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 de leitor de origem. Este parâmetro pode ser NULL.

[out] ppSourceReader

Recebe um ponteiro para a interface IMFSourceReader . 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_DRM_UNSUPPORTED
A origem contém conteúdo protegido.

Comentários

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:

Essa função 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
Biblioteca Mfreadwrite.lib
DLL Mfreadwrite.dll

Confira também

Funções do Media Foundation

Leitor de Origem