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)