Fungsi XInputGetCapabilities (xinput.h)

Artikel
10/28/2023

Mengambil kemampuan dan fitur pengontrol yang terhubung.

Sintaks

DWORD XInputGetCapabilities(
  [in]  DWORD               dwUserIndex,
  [in]  DWORD               dwFlags,
  [out] XINPUT_CAPABILITIES *pCapabilities
);

Parameter

[in] dwUserIndex

Indeks pengontrol pengguna. Bisa menjadi nilai dalam rentang 0–3. Untuk informasi tentang bagaimana nilai ini ditentukan dan bagaimana nilai memetakan ke indikator pada pengontrol, lihat Beberapa Pengontrol.

[in] dwFlags

Bendera input yang mengidentifikasi jenis pengontrol. Jika nilai ini adalah 0, maka kemampuan semua pengontrol yang terhubung ke sistem dikembalikan. Saat ini, hanya satu nilai yang didukung:

Nilai	Deskripsi
XINPUT_FLAG_GAMEPAD	Batasi kueri ke perangkat jenis pengontrol.

Setiap nilai dwflags selain yang di atas atau 0 adalah ilegal dan akan mengakibatkan kerusakan kesalahan saat penelusuran kesalahan.

[out] pCapabilities

Arahkan ke struktur XINPUT_CAPABILITIES yang menerima kemampuan pengontrol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika pengontrol tidak tersambung, nilai yang dikembalikan adalah ERROR_DEVICE_NOT_CONNECTED.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan yang ditentukan dalam WinError.h. Fungsi ini tidak menggunakan SetLastError untuk mengatur kode kesalahan terakhir utas panggilan.

Keterangan

Catatan Versi XINPUT 9.1.0 warisan (termasuk dalam Windows Vista dan yang lebih baru) selalu mengembalikan serangkaian kemampuan tetap terlepas dari perangkat yang terpasang.

Persyaratan Platform

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

Persyaratan


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

Lihat juga

Fungsi XInput

XInputGetState

XInputSetState

Bagikan melalui