MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID attribute

Specifies the identifier for the audio endpoint device.

Data type

Wide-character string

Remarks

You can use this attribute to configure the audio renderer. The usage depends on which function you call to create the audio renderer:

• MFCreateAudioRenderer: Set this attribute using the IMFAttributes interface pointer specified in the pAudioAttributes parameter.
• MFCreateAudioRendererActivate: Set this attribute using the IMFActivate interface pointer retrieved in the ppActivate parameter. Set the attribute before calling IMFActivate::ActivateObject.

An audio endpoint device is a hardware device that lies at one end of an audio data path, such as a headphone or a speaker. To obtain the audio endpoint identifier, use the following core audio APIs:

• Use the IMMDeviceEnumerator interface to enumerate the devices on the system.
• Call IMMDevice::GetId to get the identifier for the device.

For more information, see the Core Audio API documentation. If this attribute is not set, the audio renderer uses the default endpoint device.

If this attribute is set, do not set the MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE attribute. If both attributes are set, a failure will occur when the audio renderer is created.

The GUID constant for this attribute is exported from mfuuid.lib.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Mfidl.h

See also

Alphabetical List of Media Foundation Attributes

Audio Renderer Attributes

IMFAttributes::GetString

IMFAttributes::SetString

Streaming Audio Renderer