Méthode IDirectInputEffectDriver ::SendForceFeedbackCommand (dinputd.h)

Article
02/28/2024

La méthode IDirectInputEffectDriver ::SendForceFeedbackCommand modifie l’état de la rétroaction de force pour l’appareil.

Syntaxe

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Paramètres

unnamedParam1

Indique le numéro de joystick externe adressé.

unnamedParam2

Indique laquelle des commandes suivantes est envoyée :

DISFFC_RESET

Indique que la lecture des effets actifs doit être arrêtée et que tous les effets doivent être supprimés de l’appareil. Une fois l’appareil réinitialisé, tous les effets ne sont plus valides et doivent être recréés.

DISFFC_STOPALL

Indique que la lecture de tous les effets doit être arrêtée. L’envoi de la commande DISFFC_STOPALL équivaut à appeler la méthode IDirectInputEffect ::Stop sur tous les effets en cours de lecture. Si l’appareil est dans un état suspendu, le pilote de périphérique est autorisé à perdre l’état suspendu.

DISFFC_PAUSE

Indique que la lecture de tous les effets doit être suspendue. Lorsque les effets sont suspendus, le temps « s’arrête » jusqu’à ce que la commande DISFFC_CONTINUE soit envoyée. Par exemple, supposons qu’un effet d’une durée de cinq secondes soit démarré. Après une seconde, tous les effets sont suspendus. Après deux secondes supplémentaires, tous les effets sont poursuivis. L’effet doit ensuite être lu pendant quatre secondes supplémentaires. Pendant qu’un appareil de retour de force est suspendu, le démarrage d’un nouvel effet ou la modification de ceux existants peut entraîner la perte de l’état suspendu.

DISFFC_CONTINUE

Indique que la lecture doit reprendre au point où elle a été interrompue pour les effets qui ont été suspendus par une commande DISFFC_PAUSE précédente.

DISFFC_SETACTUATORSON

Indique que les actionneurs de retour de force de l’appareil doivent être activés.

DISFFC_SETACTUATORSOFF

Indique que les actionneurs de retour de force de l’appareil doivent être désactivés. En cas de réussite, les effets de la rétroaction de force sont « désactivés ». Notez que le temps continue de s’écouler pendant que les actionneurs sont éteints. Par exemple, supposons qu’un effet d’une durée de cinq secondes soit démarré. Après une seconde, les actionneurs sont désactivés. Après deux secondes supplémentaires, les actionneurs sont de nouveau activés. L’effet doit ensuite être lu pendant deux secondes supplémentaires.

Valeur retournée

Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dinputd.h (inclure Dinputd.h)

Partager via