STI_DEVICE_STATUS Struktur (sti.h)
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
Nicht verwendet.
dwPollingInterval
Zeitwert in Millisekunden, der angibt, wie oft das Gerät abgefragt werden soll, wenn eine Abfrage erforderlich ist.
Anforderungen
Anforderung | Wert |
---|---|
Header | sti.h (einschließlich Sti.h) |