XInputGetAudioDeviceIds-Funktion (xinput.h)
Ruft die Audiogeräte-IDs ab, die dem Headset zugeordnet sind, das mit dem angegebenen Controller verbunden ist.
Syntax
DWORD XInputGetAudioDeviceIds(
[in] DWORD dwUserIndex,
[out, optional] LPWSTR pRenderDeviceId,
[in, out, optional] UINT *pRenderCount,
[out, optional] LPWSTR pCaptureDeviceId,
[in, out, optional] UINT *pCaptureCount
);
Parameter
[in] dwUserIndex
Index des dem Gerät zugeordneten Spielers.
[out, optional] pRenderDeviceId
Windows Core Audio-Geräte-ID-Zeichenfolge für rendern (Lautsprecher).
[in, out, optional] pRenderCount
Größe des Rendergeräte-ID-Zeichenfolgenpuffers in Breitzeichen.
[out, optional] pCaptureDeviceId
Windows Core Audio-Geräte-ID-Zeichenfolge für die Erfassung (Mikrofon).
[in, out, optional] pCaptureCount
Größe des Erfassungsgeräte-ID-Zeichenfolgenpuffers in Breitzeichen.
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 NULL als Werte für pRenderDeviceId und pCaptureDeviceId ab.
Wenn das Controllerportgerät nicht physisch verbunden ist, gibt die Funktion ERROR_DEVICE_NOT_CONNECTED zurück.
Wenn die Funktion fehlschlägt, wird ein gültiger Win32-Fehlercode zurückgegeben.
Hinweise
Aufrufer müssen den Arbeitsspeicher für die Puffer zuordnen, die an XInputGetAudioDeviceIds übergeben werden. Die resultierenden Zeichenfolgen können von beliebiger Länge sein.
Plattformanforderungen
Windows 8 (XInput 1.4)Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | xinput.h |
| Bibliothek | Xinput.lib |
| DLL | Xinput1_4.dll |