MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID-Attribut

Gibt den Bezeichner für das Audioendpunktgerät an.

Datentyp

Breitzeichenfolge

Bemerkungen

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

• 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 wird. Legen Sie das Attribut vor dem Aufrufen von IMFActivate::ActivateObject fest.

Ein Audioendpunktgerät ist ein Hardwaregerät, das sich an einem Ende eines Audiodatenpfads befindet, z. B. ein Kopfhörer oder ein Lautsprecher. Verwenden Sie zum Abrufen des Audioendpunktbezeichners die folgenden kernigen Audio-APIs:

• Verwenden Sie die IMMDeviceEnumerator-Schnittstelle , um die Geräte im System aufzulisten.
• Rufen Sie IMMDevice::GetId auf, um den Bezeichner für das Gerät abzurufen.

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 nicht das attribut MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE fest. Wenn beide Attribute festgelegt sind, tritt beim Erstellen des Audiorenderers ein Fehler auf.

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

Weitere Informationen

Alphabetische Liste der Media Foundation-Attribute

Audiorendererattribute

IMFAttributes::GetString

IMFAttributes::SetString

Streaming-Audiorenderer