STI_DEVICE_STATUS struttura (sti.h)
La struttura STI_DEVICE_STATUS viene usata come parametro per i metodi IStiDevice::GetStatus e IStiUSD::GetStatus.
Sintassi
typedef struct _STI_DEVICE_STATUS {
DWORD dwSize;
DWORD StatusMask;
DWORD dwOnlineState;
DWORD dwHardwareStatusCode;
DWORD dwEventHandlingState;
DWORD dwPollingInterval;
} STI_DEVICE_STATUS, *PSTI_DEVICE_STATUS;
Members
dwSize
Dimensioni fornite dal chiamante, in byte, della struttura STI_DEVICE_STATUS.
StatusMask
Uno o più flag di bit forniti dal chiamante, che indica il tipo di informazioni sullo stato richieste. I flag seguenti sono definiti:
Flag | Definizione |
---|---|
STI_DEVSTATUS_EVENTS_STATE | Il driver deve compilare il membro dwEventHandlingState . |
STI_DEVSTATUS_ONLINE_STATE | Il driver deve compilare il membro dwOnlineState . |
dwOnlineState
Flag di bit che indicano lo stato corrente del dispositivo. I flag seguenti sono definiti in Sti.h.
Attualmente è necessario usare STI_ONLINESTATE_OPERATIONAL, mentre l'uso di tutti gli altri flag è facoltativo. Attualmente, STI_ONLINESTATE_OPERATIONAL è l'unico flag controllato dal server di immagini ancora.
STI_ONLINESTATE_BUSY
Il dispositivo è occupato.
STI_ONLINESTATE_ERROR
Il dispositivo ha segnalato un errore.
STI_ONLINESTATE_INITIALIZING
Il dispositivo viene inizializzato.
STI_ONLINESTATE_IO_ACTIVE
Il dispositivo è attivo ma non accetta i comandi.
STI_ONLINESTATE_OFFLINE
Il dispositivo è fuori linea.
STI_ONLINESTATE_OPERATIONAL
Il dispositivo è online e pronto. Se impostato, Pannello di controllo indica che il dispositivo è pronto. In caso contrario, indica che il dispositivo è fuori linea.
STI_ONLINESTATE_PAPER_JAM
Il dispositivo ha segnalato una marmellata di carta.
STI_ONLINESTATE_PAPER_PROBLEM
Il dispositivo ha segnalato un problema di carta non specificato.
STI_ONLINESTATE_PAUSED
Il dispositivo viene sospeso.
STI_ONLINESTATE_PENDING
Le operazioni di I/O sono in sospeso.
STI_ONLINESTATE_POWER_SAVE
Il dispositivo è in modalità di risparmio energia.
STI_ONLINESTATE_TRANSFERRING
Il dispositivo sta trasferendo i dati.
STI_ONLINESTATE_USER_INTERVENTION
Il dispositivo richiede l'intervento dell'utente.
STI_ONLINESTATE_WARMING_UP
Il dispositivo è in riscaldamento.
dwHardwareStatusCode
Valore specifico del dispositivo, definito dal fornitore facoltativo.
dwEventHandlingState
Contiene flag di bit che indicano lo stato dell'evento. I flag seguenti sono definiti in Sti.h.
STI_EVENTHANDLING_ENABLED
Non usato.
STI_EVENTHANDLING_PENDING
Si è verificato un evento del dispositivo.
STI_EVENTHANDLING_POLLING
Non usato.
dwPollingInterval
Valore di tempo, in millisecondi, che indica la frequenza con cui deve essere eseguito il polling del dispositivo, se è necessario il polling.
Requisiti
Requisito | Valore |
---|---|
Intestazione | sti.h (include Sti.h) |