Fungsi XInputGetAudioDeviceIds (xinput.h)

Mengambil penyajian suara dan ID perangkat audio tangkapan suara yang terkait dengan headset yang terhubung ke pengontrol yang ditentukan.

Sintaks

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

Indeks gamer yang terkait dengan perangkat.

[out, optional] pRenderDeviceId

String ID perangkat Windows Core Audio untuk render (speaker).

[in, out, optional] pRenderCount

Ukuran, dalam karakter lebar, dari penyangga string ID perangkat render.

[out, optional] pCaptureDeviceId

String ID perangkat Windows Core Audio untuk pengambilan (mikrofon).

[in, out, optional] pCaptureCount

Ukuran, dalam karakter lebar, dari buffer string ID perangkat tangkap.

Nilai kembali

Jika fungsi berhasil mengambil ID perangkat untuk dirender dan diambil, kode pengembalian ERROR_SUCCESS.

Jika tidak ada headset yang terhubung ke pengontrol, fungsi juga akan mengambil ERROR_SUCCESS dengan NULL sebagai nilai untuk pRenderDeviceId dan pCaptureDeviceId.

Jika perangkat port pengontrol tidak terhubung secara fisik, fungsi akan mengembalikan ERROR_DEVICE_NOT_CONNECTED.

Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan Win32 yang valid.

Keterangan

Pemanggil harus mengalokasikan memori untuk buffer yang diteruskan ke XInputGetAudioDeviceIds. String yang dihasilkan dapat memiliki panjang arbitrer.

Persyaratan Platform

Windows 8 (XInput 1.4)

Persyaratan

Target Platform	Windows
Header	xinput.h
Pustaka	Xinput.lib
DLL	Xinput1_4.dll

Lihat juga

API Audio Inti

Fungsi XInput

XInputGetDSoundAudioDeviceGuids