estrutura STI_DEVICE_STATUS (sti.h)

Artigo
02/07/2025

A estrutura STI_DEVICE_STATUS é usada como um parâmetro para os métodos IStiDevice::GetStatus e métodos IStiUSD::GetStatus.

Sintaxe

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

Membros

dwSize

Tamanho fornecido pelo chamador, em bytes, da estrutura de STI_DEVICE_STATUS.

StatusMask

Um ou mais sinalizadores de bits fornecidos pelo chamador, indicando o tipo de informações de status que estão sendo solicitadas. Os seguintes sinalizadores são definidos:

Bandeira	Definição
STI_DEVSTATUS_EVENTS_STATE	O driver deve preencher o membro dwEventHandlingState.
STI_DEVSTATUS_ONLINE_STATE	O driver deve preencher o membro dwOnlineState.

dwOnlineState

Sinalizadores de bits que indicam o status atual do dispositivo. Os sinalizadores a seguir são definidos em Sti.h.

Atualmente, o uso de STI_ONLINESTATE_OPERATIONAL é necessário, enquanto o uso de todos os outros sinalizadores é opcional. (Atualmente, STI_ONLINESTATE_OPERATIONAL é o único sinalizador que o servidor de imagem ainda verifica.)

STI_ONLINESTATE_BUSY

O dispositivo está ocupado.

STI_ONLINESTATE_ERROR

O dispositivo relatou um erro.

STI_ONLINESTATE_INITIALIZING

O dispositivo está sendo inicializado.

STI_ONLINESTATE_IO_ACTIVE

O dispositivo está ativo, mas não aceita comandos.

STI_ONLINESTATE_OFFLINE

O dispositivo está off-line.

STI_ONLINESTATE_OPERATIONAL

O dispositivo está online e pronto. Se definido, o Painel de Controle indica que o dispositivo está pronto. Caso contrário, indica que o dispositivo está off-line.

STI_ONLINESTATE_PAPER_JAM

O dispositivo relatou um congestionamento de papel.

STI_ONLINESTATE_PAPER_PROBLEM

O dispositivo relatou um problema de papel não especificado.

STI_ONLINESTATE_PAUSED

O dispositivo está em pausa.

STI_ONLINESTATE_PENDING

As operações de E/S estão pendentes.

STI_ONLINESTATE_POWER_SAVE

O dispositivo está no modo de economia de energia.

STI_ONLINESTATE_TRANSFERRING

O dispositivo está transferindo dados.

STI_ONLINESTATE_USER_INTERVENTION

O dispositivo requer intervenção do usuário.

STI_ONLINESTATE_WARMING_UP

O dispositivo está se aquecendo.

dwHardwareStatusCode

Valor definido pelo fornecedor e específico do dispositivo opcional.

dwEventHandlingState

Contém sinalizadores de bits que indicam o status do evento. Os sinalizadores a seguir são definidos em Sti.h.

STI_EVENTHANDLING_ENABLED

Não usado.

STI_EVENTHANDLING_PENDING

Ocorreu um evento de dispositivo.

STI_EVENTHANDLING_POLLING