XInputGetDSoundAudioDeviceGuids-Funktion (xinput.h)

  • Artikel

Ruft die GUIDs für Soundrendering- und Soundaufzeichnungsgeräte ab, die dem Headset zugeordnet sind, das mit dem angegebenen Controller verbunden ist.

Syntax

DWORD XInputGetDSoundAudioDeviceGuids(
  DWORD dwUserIndex,
  GUID  *pDSoundRenderGuid,
  GUID  *pDSoundCaptureGuid
);

Parameter

dwUserIndex

[in] Index des Controller des Benutzers. Es kann sich um einen Wert im Bereich 0–3 sein. Informationen dazu, wie dieser Wert bestimmt wird und wie der Wert Indikatoren auf dem Controller zugeordnet wird, finden Sie unter Mehrere Controller.

pDSoundRenderGuid

[out] Zeiger, der die GUID des Headset-Soundrenderinggeräts empfängt.

pDSoundCaptureGuid

[out] Zeiger, der die GUID des Headset-Sounderfassungsgeräts empfängt.

Rückgabewert

Wenn die Funktion die Geräte-IDs zum Rendern und Erfassen erfolgreich abruft, wird der Rückgabecode ERROR_SUCCESS.

Wenn kein Headset mit dem Controller verbunden ist, ruft die Funktion auch ERROR_SUCCESS mit GUID_NULL als Werte für pDSoundRenderGuid und pDSoundCaptureGuid ab.

Wenn das Controllerportgerät nicht physisch verbunden ist, gibt die Funktion ERROR_DEVICE_NOT_CONNECTED zurück.

Wenn die Funktion fehlschlägt, gibt sie einen gültigen Win32-Fehlercode zurück.

Hinweise

Die Verwendung von Legacy-DirectSound wird nicht empfohlen, und DirectSound ist für Windows Store-Apps nicht verfügbar.

Hinweis: XInputGetDSoundAudioDeviceGuids ist veraltet, da es von Windows 8 (XInput 1.4) nicht unterstützt wird.
 

Plattformanforderungen

DirectX SDK (XInput 1.3), Windows Vista (XInput 9.1.0)

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile xinput.h
Bibliothek Xinput.lib; Xinput9_1_0.lib
DLL Xinput9_1_0.dll

Weitere Informationen

XInput-Funktionen

XInputGetState