MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE 属性

指定音频呈现器的音频终结点角色。

数据类型

UINT32

可以使用此属性来配置音频呈现器。用法取决于调用哪个函数来创建音频呈现器：

MFCreateAudioRenderer：使用 pAudioAttributes 参数中指定的 IMFAttributes 接口指针设置此属性。
MFCreateAudioRendererActivate：使用在 ppActivate 参数中检索到的 IMFActivate 接口指针设置此属性。在调用 IMFActivate：：ActivateObject 之前设置属性。

音频终结点设备是位于音频数据路径的一端的硬件设备，例如耳机或扬声器。

如果设置了此属性，音频呈现器将使用指定角色的默认音频设备。此属性的值是 ERole 枚举的成员，该枚举在头文件 mmdeviceapi.h 中定义。有关详细信息，请参阅核心音频 API 文档。如果未设置此属性，音频呈现器将使用默认终结点设备。

如果设置了此属性，请不要设置 MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID 属性。如果同时设置了这两个属性，则创建音频呈现器时将失败。

此属性的 GUID 常量是从 mfuuid.lib 导出的。