Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die PKEY_AudioEndpoint_GUID-Eigenschaft stellt den DirectSound-Gerätebezeichner bereit, der dem Audioendpunktgerät entspricht. Der Eigenschaftswert ist eine GUID, die der Client als Gerätebezeichner für die Funktion DirectSoundCreate oder DirectSoundCaptureCreate in der DirectSound-API bereitstellen kann. Dieser Wert identifiziert das Audioendpunktgerät auf allen Audioendpunktgeräten im System eindeutig. Weitere Informationen zu DirectSound finden Sie in der Dokumentation zum DirectX SDK.
Der vt-Member der PROPVARIANT-Struktur ist auf VT_LPWSTR festgelegt.
Das pwszVal-Element der PROPVARIANT-Struktur zeigt auf eine null-endende Breitzeichenzeichenfolge, die eine GUID enthält, die das Audioendpunktgerät in DirectSound identifiziert.
Wie bereits erläutert, unterstützt die MMDevice-APIGeräterollen. Obwohl DirectSound Geräterollen nicht direkt unterstützt, kann ein DirectSound-Client die eigenschaft PKEY_AudioEndpoint_GUID verwenden, um ein DirectSound-Rendering- oder Erfassungsgerät basierend auf seiner Geräterolle auszuwählen.
Eine DirectSound-Anwendung führt beispielsweise die folgenden Schritte aus, um ein DirectSound-Gerät zu erstellen, das dem Renderingendpunktgerät entspricht, dem der Benutzer die Rolle eMultimedia zugewiesen hat:
- Rufen Sie die IMMDeviceEnumerator::GetDefaultAudioEndpoint-Methode auf, um die IMMDevice-Schnittstelle des Renderingendpunktgeräts mit der Rolle eMultimedia abzurufen.
- Rufen Sie die IMMDevice::OpenPropertyStore-Methode auf, um die IPropertyStore-Schnittstelle des eMultimedia-Geräts abzurufen. Weitere Informationen zu IPropertyStore finden Sie in der Windows SDK-Dokumentation.
- Rufen Sie die IPropertyStore::GetValue-Methode auf, um den Wert der PKEY_AudioEndpoint_GUID-Eigenschaft abzurufen.
- Konvertieren Sie den Eigenschaftswert aus einer GUID im Zeichenfolgenformat in eine GUID-Struktur mit 16 Byte.
- Rufen Sie die DirectSoundCreate-Funktion mit der GUID auf, um das Gerät mit der Rolle eMultimedia zu erstellen.
Hinweis
PKEY_AudioEndpoint_GUID ist eine schreibgeschützte Eigenschaft, unabhängig vom Speicherzugriffsmodus, der von der Anwendung in IMMDevice::OpenPropertyStore angefordert wird. Wenn eine Anwendung versucht, einen Wert mithilfe von IPropertyStore::SetValue festzulegen, schlägt dieser Aufruf mit dem fehlercode E_ACCESSDENIED fehl.
Beachten Sie, dass die in Schritt 4 generierte 16-Byte-GUID mit der Geräte-GUID übereinstimmt, die das Gerät während der DirectSound-Geräteenumeration identifiziert. Die DirectSoundEnumerate-Funktion listet Renderingendpunktgeräte auf, und die DirectSoundCaptureEnumerate-Funktion listet Erfassungsendpunkte auf. In beiden Fällen ist die Geräte-GUID der erste Parameter, der an die Enumerationsrückruffunktion übergeben wird. Weitere Informationen zur DirectSound-Enumeration finden Sie in der Dokumentation zum DirectX SDK.
Ein Codebeispiel, das die PKEY_AudioEndpoint_GUID-Eigenschaft verwendet, finden Sie unter Geräterollen für DirectSound-Anwendungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
Siehe auch