Fungsi XInputEnable (xinput.h)

Mengatur status pelaporan XInput.

Sintaksis

void XInputEnable(
  [in] BOOL enable
);

Parameter

[in] enable

Jika pengaktifan FALSE, XInput hanya akan mengirim data netral sebagai respons terhadap XInputGetState (semua tombol naik, sumbu berpusat, dan pemicu pada 0). panggilan XInputSetState akan didaftarkan tetapi tidak dikirim ke perangkat. Mengirim nilai apa pun selain FALSE akan memulihkan fungsionalitas membaca dan menulis ke normal.

Mengembalikan nilai

Tidak

Komentar

Fungsi ini dimaksudkan untuk dipanggil ketika aplikasi mendapatkan atau kehilangan fokus (seperti melalui WM_ACTIVATEAPP). Dengan menggunakan fungsi ini, Anda tidak perlu mengubah perulangan kueri XInput di aplikasi Anda karena data netral akan selalu dilaporkan jika XInput dinonaktifkan.

Dalam pengontrol yang mendukung efek getaran:

• Melewati FALSE akan menghentikan efek getaran yang saat ini dimainkan. Dalam status ini, panggilan ke XInputSetState akan didaftarkan, tetapi tidak diteruskan ke perangkat.
• Meneruskan TRUE akan meneruskan permintaan getaran terakhir (bahkan jika 0) dikirim ke XInputSetState ke perangkat.

Windows 10 atau yang lebih baru:tidak digunakan lagi, karena input pengontrol game diaktifkan/dinonaktifkan secara otomatis oleh sistem berdasarkan fokus jendela aplikasi.

Persyaratan Platform

Windows 8 (XInput 1.4), Directx SDK (XInput 1.3)

Persyaratan

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

Lihat juga

XINPUT_GAMEPAD

XINPUT_STATE

XInput Functions

XInputGetState

XInputSetState