XInputGetDSoundAudioDeviceGuids-Funktion (xinput.h)
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.
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 |