STI_DEVICE_STATUS Struktur (sti.h)

Artikel
02/29/2024

Die STI_DEVICE_STATUS-Struktur wird als Parameter für die Methoden IStiDevice::GetStatus und IStiUSD::GetStatus verwendet.

Syntax

typedef struct _STI_DEVICE_STATUS {
  DWORD dwSize;
  DWORD StatusMask;
  DWORD dwOnlineState;
  DWORD dwHardwareStatusCode;
  DWORD dwEventHandlingState;
  DWORD dwPollingInterval;
} STI_DEVICE_STATUS, *PSTI_DEVICE_STATUS;

Member

dwSize

Vom Aufrufer bereitgestellte Größe der STI_DEVICE_STATUS-Struktur in Bytes.

StatusMask

Mindestens ein vom Aufrufer bereitgestelltes Bitflags, das den Typ der angeforderten status Informationen angibt. Die folgenden Flags werden definiert:

Flag	Definition
STI_DEVSTATUS_EVENTS_STATE	Der Treiber sollte das dwEventHandlingState-Element ausfüllen.
STI_DEVSTATUS_ONLINE_STATE	Der Treiber sollte das dwOnlineState-Element ausfüllen.

dwOnlineState

Bitflags, die die aktuelle status des Geräts angeben. Die folgenden Flags sind in Sti.h definiert.

Derzeit ist die Verwendung von STI_ONLINESTATE_OPERATIONAL erforderlich, während die Verwendung aller anderen Flags optional ist. (Derzeit ist STI_ONLINESTATE_OPERATIONAL das einzige Flag, das vom Standbildserver überprüft wird.)

STI_ONLINESTATE_BUSY

Das Gerät ist ausgelastet.

STI_ONLINESTATE_ERROR

Das Gerät hat einen Fehler gemeldet.

STI_ONLINESTATE_INITIALIZING

Das Gerät wird initialisiert.

STI_ONLINESTATE_IO_ACTIVE

Das Gerät ist aktiv, akzeptiert aber keine Befehle.

STI_ONLINESTATE_OFFLINE

Das Gerät ist offline.

STI_ONLINESTATE_OPERATIONAL

Das Gerät ist online und bereit. Wenn festgelegt, gibt Systemsteuerung an, dass das Gerät bereit ist. Andernfalls wird darauf hingewiesen, dass das Gerät offline ist.

STI_ONLINESTATE_PAPER_JAM

Das Gerät hat einen Papierstau gemeldet.

STI_ONLINESTATE_PAPER_PROBLEM

Das Gerät hat ein nicht spezifiziertes Papierproblem gemeldet.

STI_ONLINESTATE_PAUSED

Das Gerät wird angehalten.

STI_ONLINESTATE_PENDING

E/A-Vorgänge stehen aus.

STI_ONLINESTATE_POWER_SAVE

Das Gerät befindet sich im Energiesparmodus.

STI_ONLINESTATE_TRANSFERRING

Das Gerät überträgt Daten.

STI_ONLINESTATE_USER_INTERVENTION

Das Gerät erfordert einen Benutzereingriff.

STI_ONLINESTATE_WARMING_UP

Das Gerät erwärmt sich.

dwHardwareStatusCode

Optionaler gerätespezifischer, vom Hersteller definierter Wert.

dwEventHandlingState

Enthält Bitflags, die das Ereignis status. Die folgenden Flags sind in Sti.h definiert.

STI_EVENTHANDLING_ENABLED

Nicht verwendet.

STI_EVENTHANDLING_PENDING

Es ist ein Geräteereignis aufgetreten.

STI_EVENTHANDLING_POLLING