DIDEVICESTATE-Struktur (dinputd.h)

Artikel
03/04/2024

Die DIDEVICESTATE-Struktur gibt Informationen über den Zustand eines Force Feedback-Geräts zurück.

Syntax

typedef struct DIDEVICESTATE {
  DWORD dwSize;
  DWORD dwState;
  DWORD dwLoad;
} DIDEVICESTATE, *LPDIDEVICESTATE;

Member

dwSize

Gibt die Größe der Struktur in Bytes an. Dieses Element muss initialisiert werden, bevor die Struktur verwendet wird.

dwState

Gibt verschiedene Aspekte des Gerätezustands an. Kann null, ein oder mehrere der folgenden Elemente angeben:

DIGFFS_EMPTY

Gibt an, dass das Erzwingungsfeedbackgerät keine heruntergeladenen Effekte enthält.

DIGFFS_STOPPED

Gibt an, dass derzeit keine Effekte wiedergegeben werden und das Gerät nicht angehalten wird.

DIGFFS_PAUSED

Gibt an, dass die Wiedergabe von Effekten durch einen vorherigen DISFFC_PAUSE-Befehl angehalten wurde.

DIGFFS_ACTUATORSON

Gibt an, dass die Kraft-Feedback-Aktoren des Geräts aktiviert sind.

DIGFFS_ACTUATORSOFF

Gibt an, dass die Kraft-Feedback-Aktoren des Geräts deaktiviert sind.

DIGFFS_POWERON

Gibt an, dass die Stromversorgung für das Force-Feedback-System derzeit verfügbar ist. Wenn das Gerät den Energiezustand nicht melden kann, sollte weder DIGFFS_POWERON noch DIGFFS_POWEROFF zurückgegeben werden.

DIGFFS_POWEROFF

Gibt an, dass die Stromversorgung für das Force-Feedback-System derzeit nicht verfügbar ist. Wenn das Gerät den Energiezustand nicht melden kann, sollte weder DIGFFS_POWERON noch DIGFFS_POWEROFF zurückgegeben werden.

DIGFFS_SAFETYSWITCHON

Gibt an, dass der Sicherheitsschalter (Dead-Man-Schalter) derzeit eingeschaltet ist, was bedeutet, dass das Gerät betrieben werden kann. Wenn das Gerät den Zustand des Sicherheitsschalters nicht melden kann, sollten weder DIGFFS_SAFETYSWITCHON noch DIGFFS_SAFETYSWITCHOFF zurückgegeben werden.

DIGFFS_SAFETYSWITCHOFF

Gibt an, dass der Sicherheitsschalter (Dead-Man-Schalter) derzeit ausgeschaltet ist, was bedeutet, dass das Gerät nicht betrieben werden kann. Wenn das Gerät den Zustand des Sicherheitsschalters nicht melden kann, sollten weder DIGFFS_SAFETYSWITCHON noch DIGFFS_SAFETYSWITCHOFF zurückgegeben werden.

DIGFFS_USERFFSWITCHON

Gibt an, dass der Schalter "Erzwingen des Feedbacks" des Benutzers derzeit aktiviert ist, was bedeutet, dass das Gerät betrieben werden kann. Wenn das Gerät den Zustand des Benutzer-Erzwingungsfeedbackschalters nicht melden kann, sollte weder DIGFFS_USERFFSWITCHON noch DIGFFS_USERFFSWITCHOFF zurückgegeben werden.

DIGFFS_USERFFSWITCHOFF

Gibt an, dass der Benutzer das Feedback-Erzwingen derzeit deaktiviert ist, was bedeutet, dass das Gerät nicht betrieben werden kann. Wenn das Gerät den Zustand des Benutzer-Erzwingungsfeedbackschalters nicht melden kann, sollte weder DIGFFS_USERFFSWITCHON noch DIGFFS_USERFFSWITCHOFF zurückgegeben werden.

DIGFFS_DEVICELOST

Gibt an, dass das Gerät einen unerwarteten Fehler erlitten hat und sich in einem unbestimmten Zustand befindet. Es muss entweder durch Aufheben und Erneutes Abrufen des Geräts oder durch explizites Senden eines DISFFC_RESET-Befehls zurückgesetzt werden. Beispielsweise kann das Gerät verloren gehen, wenn der Benutzer den Computer ansetzt, wodurch der Onboardspeicher auf dem Gerät verloren geht.

dwLoad

Ein Wert, der den Prozentsatz des verwendeten Gerätespeichers angibt. Der Wert null gibt an, dass der Gerätespeicher vollständig verfügbar ist. Der Wert 100 gibt an, dass das Gerät voll ist.

Anforderungen

Anforderung	Wert
Header	dinputd.h

Freigeben über