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

Requirements (Anforderungen)

Weitere Informationen

Core-Audio-APIs

XInput-Funktionen

XInputGetDSoundAudioDeviceGuids