Fungsi XInputEnable (xinput.h)

Artikel
03/05/2024

Mengatur status pelaporan XInput.

Sintaks

void XInputEnable(
  [in] BOOL enable
);

Parameter

[in] enable

Jika aktifkan 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.

Nilai kembali

Tidak ada

Keterangan

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 diputar. 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 secara otomatis diaktifkan/dinonaktifkan oleh sistem berdasarkan fokus jendela aplikasi.