MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE Attribut

Gibt die Audioendpunktrolle für den Audiorenderer an.

Datentyp

UINT32

Hinweise

Sie können dieses Attribut verwenden, um den Audiorenderer zu konfigurieren. Die Verwendung hängt davon ab, welche Funktion Sie aufrufen, um den Audiorenderer zu erstellen:

• MFCreateAudioRenderer: Legen Sie dieses Attribut mithilfe des IMFAttributes-Schnittstellenzeigers fest, der im pAudioAttributes-Parameter angegeben ist.
• MFCreateAudioRendererActivate: Legen Sie dieses Attribut mithilfe des IMFActivate-Schnittstellenzeigers fest, der im ppActivate-Parameter abgerufen wurde. Legen Sie das Attribut vor dem Aufrufen von IMFActivate::ActivateObject fest.

Ein Audioendpunktgerät ist ein Hardwaregerät, das an einem Ende eines Audiodatenpfads liegt, z. B. einen Kopfhörer oder einen Lautsprecher.

Wenn dieses Attribut festgelegt ist, verwendet der Audiorenderer das Standardaudiogerät für die angegebene Rolle. Der Wert dieses Attributs ist ein Element der ERole-Enumeration , die in der Headerdatei mmdeviceapi.h definiert ist. Weitere Informationen finden Sie in der Dokumentation zur Core Audio API. Wenn dieses Attribut nicht festgelegt ist, verwendet der Audiorenderer das Standardendpunktgerät.

Wenn dieses Attribut festgelegt ist, legen Sie das MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID-Attribut nicht fest. Wenn beide Attribute festgelegt sind, tritt ein Fehler auf, wenn der Audiorenderer erstellt wird.

Die GUID-Konstante für dieses Attribut wird aus mfuuid.lib exportiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Nur Desktop-Apps]
Header	Mfidl.h

Siehe auch

Alphabetische Liste der Media Foundation-Attribute

Audiorendererattribute

IMFAttributes::GetUINT32

IMFAttributes::SetUINT32

Streaming-Audiorenderer