atributo MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID

Especifica o identificador do dispositivo de ponto de extremidade de áudio.

Tipo de dados

Cadeia de caracteres largos

Comentários

Você pode usar esse atributo para configurar o renderizador de áudio. O uso depende de qual função você chama para criar o renderizador de áudio:

• MFCreateAudioRenderer: defina esse atributo usando o ponteiro da interface IMFAttributes especificado no parâmetro pAudioAttributes .
• MFCreateAudioRendererActivate: defina esse atributo usando o ponteiro da interface IMFActivate recuperado no parâmetro ppActivate . Defina o atributo antes de chamar IMFActivate::ActivateObject.

Um dispositivo de ponto de extremidade de áudio é um dispositivo de hardware que está em uma extremidade de um caminho de dados de áudio, como um fone de ouvido ou um alto-falante. Para obter o identificador de ponto de extremidade de áudio, use as seguintes APIs de áudio principais:

• Use a interface IMMDeviceEnumerator para enumerar os dispositivos no sistema.
• Chame IMMDevice::GetId para obter o identificador do dispositivo.

Para obter mais informações, consulte a documentação da API de Áudio Principal . Se esse atributo não estiver definido, o renderizador de áudio usará o dispositivo de ponto de extremidade padrão.

Se esse atributo for definido, não defina o atributo MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE . Se ambos os atributos forem definidos, ocorrerá uma falha quando o renderizador de áudio for criado.

A constante GUID para esse atributo é exportada de mfuuid.lib.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Mfidl.h

Confira também

Lista alfabética de atributos da Media Foundation

Atributos do Renderizador de Áudio

IMFAttributes::GetString

IMFAttributes::SetString

Renderizador de áudio de streaming