Metode IDirectInputEffectDriver::SendForceFeedbackCommand (dinputd.h)

Artikel
08/23/2023

Metode IDirectInputEffectDriver::SendForceFeedbackCommand mengubah status force-feedback untuk perangkat.

Sintaks

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Parameter

unnamedParam1

Menunjukkan nomor joystick eksternal yang sedang ditangani.

unnamedParam2

Menunjukkan perintah mana yang sedang dikirim:

DISFFC_RESET

Menunjukkan bahwa pemutaran efek aktif apa pun harus dihentikan dan bahwa semua efek harus dihapus dari perangkat. Setelah perangkat direset, semua efek tidak lagi valid dan harus dibuat ulang.

DISFFC_STOPALL

Menunjukkan bahwa pemutaran semua efek harus dihentikan. Mengirim perintah DISFFC_STOPALL setara dengan memanggil metode IDirectInputEffect::Stop pada semua efek yang sedang diputar. Jika perangkat dalam keadaan dijeda, driver perangkat diizinkan untuk kehilangan status dijeda.

DISFFC_PAUSE

Menunjukkan bahwa pemutaran semua efek harus dijeda. Ketika efek dijeda, waktu "berhenti" sampai perintah DISFFC_CONTINUE dikirim. Misalnya, efek durasi lima detik dimulai. Setelah satu detik, semua efek dijeda. Setelah dua detik lagi, semua efek dilanjutkan. Efeknya kemudian harus diputar selama empat detik tambahan. Saat perangkat umpan balik paksa dijeda, memulai efek baru atau memodifikasi yang ada dapat menyebabkan status jeda hilang.

DISFFC_CONTINUE

Menunjukkan bahwa pemutaran harus dilanjutkan pada titik di mana ia terganggu untuk efek yang dijeda oleh perintah DISFFC_PAUSE sebelumnya.

DISFFC_SETACTUATORSON

Menunjukkan bahwa aktuator umpan balik paksa perangkat harus diaktifkan.

DISFFC_SETACTUATORSOFF

Menunjukkan bahwa aktuator umpan balik paksa perangkat harus dinonaktifkan. Jika berhasil, efek umpan balik paksa "dibisukan". Perhatikan bahwa waktu terus berlalu saat aktuator nonaktif. Misalnya, efek durasi lima detik dimulai. Setelah satu detik, aktuator dimatikan. Setelah dua detik lagi, aktuator dihidupkan kembali. Efeknya kemudian harus diputar selama dua detik tambahan.

Nilai kembali

Mengembalikan S_OK jika berhasil; jika tidak, mengembalikan kode kesalahan.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dinputd.h (termasuk Dinputd.h)