IDirectInputEffectDriver::SendForceFeedbackCommand-Methode (dinputd.h)

Die IDirectInputEffectDriver::SendForceFeedbackCommand-Methode ändert den Force-Feedback-Zustand für das Gerät.

Syntax

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Parameter

unnamedParam1

Gibt die externe Joysticknummer an, die adressiert wird.

unnamedParam2

Gibt an, welcher der folgenden Befehle gesendet wird:

DISFFC_RESET

Gibt an, dass die Wiedergabe aktiver Effekte beendet und alle Effekte vom Gerät entfernt werden sollen. Nachdem das Gerät zurückgesetzt wurde, sind alle Effekte nicht mehr gültig und müssen neu erstellt werden.

DISFFC_STOPALL

Gibt an, dass die Wiedergabe aller Effekte beendet werden soll. Das Senden des DISFFC_STOPALL Befehls entspricht dem Aufrufen der IDirectInputEffect::Stop-Methode für alle wiedergegebenen Effekte. Wenn sich das Gerät in einem angehaltenen Zustand befindet, darf der Gerätetreiber den angehaltenen Zustand verlieren.

DISFFC_PAUSE

Gibt an, dass die Wiedergabe aller Effekte angehalten werden soll. Wenn Effekte angehalten werden, wird die Zeit "beendet", bis der befehl DISFFC_CONTINUE gesendet wird. Angenommen, ein Effekt von fünf Sekunden Dauer wird gestartet. Nach einer Sekunde werden alle Effekte angehalten. Nach zwei weiteren Sekunden werden alle Effekte fortgesetzt. Der Effekt sollte dann vier Sekunden lang wiedergegeben werden. Während ein Gerät mit Erzwungenem Feedback angehalten wird, kann das Starten eines neuen Effekts oder das Ändern vorhandener Effekte dazu führen, dass der angehaltene Zustand verloren geht.

DISFFC_CONTINUE

Gibt an, dass die Wiedergabe an dem Punkt fortgesetzt werden soll, an dem sie für die Effekte unterbrochen wurde, die durch einen vorherigen DISFFC_PAUSE-Befehl angehalten wurden.

DISFFC_SETACTUATORSON

Gibt an, dass die Force-Feedback-Aktoren des Geräts aktiviert werden sollen.

DISFFC_SETACTUATORSOFF

Gibt an, dass die Kraftrückmeldungs-Aktoren des Geräts deaktiviert werden sollen. Wenn dies erfolgreich ist, werden Rückkopplungseffekte erzwingt. Beachten Sie, dass die Zeit weiterhin vergeht, während Aktoren ausgeschaltet sind. Angenommen, ein Effekt von fünf Sekunden Dauer wird gestartet. Nach einer Sekunde werden Aktoren ausgeschaltet. Nach weiteren zwei Sekunden werden die Aktoren wieder eingeschaltet. Der Effekt sollte dann zwei weitere Sekunden lang wiedergegeben werden.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen Fehlercode zurück.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dinputd.h (include Dinputd.h)