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 |
|
See also