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.

Requirements

See Also

Audio Renderer Attributes

IMFAttributes::GetString

IMFAttributes::SetString

Streaming Audio Renderer

Send comments about this topic to Microsoft

Build date: 10/8/2009