Compartilhar via

Função MFCreateAudioRendererActivate (mfidl.h)

  • Artigo

Cria um objeto de ativação para o Renderizador de Áudio de Streaming.

Sintaxe

HRESULT MFCreateAudioRendererActivate(
  [out] IMFActivate **ppActivate
);

Parâmetros

[out] ppActivate

Recebe um ponteiro para a interface IMFActivate . Use essa interface para criar o renderizador de áudio. O chamador deve liberar a interface .

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para criar o renderizador de áudio, chame IMFActivate::ActivateObject no ponteiro IMFActivate recuperado.

Nota Para evitar uma perda de memória, chame IMFActivate::ShutdownObject antes de liberar a referência final para o renderizador de áudio ou o objeto de ativação do renderizador de áudio.
 
Para configurar o renderizador de áudio, defina qualquer um dos atributos a seguir no objeto IMFActivate antes de chamar ActivateObject. (Se você estiver usando a Sessão de Mídia, a Sessão de Mídia chamará ActivateObject automaticamente quando você enfileirar a topologia.)
Atributo Descrição
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID O identificador do dispositivo de ponto de extremidade de áudio.
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE A função de ponto de extremidade de áudio.
MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS Sinalizadores de configuração diversos.
MF_AUDIO_RENDERER_ATTRIBUTE_SESSION_ID A classe de política de áudio.
MF_AUDIO_RENDERER_ATTRIBUTE_STREAM_CATEGORY A categoria de fluxo de áudio.
MF_LOW_LATENCY Habilita o streaming de áudio de baixa latência.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mf.lib
DLL Mf.dll

Confira também

Objetos de ativação

Funções do Media Foundation

Renderizador de áudio de streaming