структура STI_DEVICE_STATUS (sti.h)

Статья
06/01/2023

Структура STI_DEVICE_STATUS используется в качестве параметра для методов IStiDevice::GetStatus и IStiUSD::GetStatus .

Синтаксис

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

Члены

dwSize

Предоставленный вызывающим элементом размер структуры STI_DEVICE_STATUS в байтах.

StatusMask

Один или несколько битовых флагов, предоставленных вызывающим абонентом, указывающих тип запрашиваемых сведений о состоянии. Определены следующие флаги:

Флаг	Определение
STI_DEVSTATUS_EVENTS_STATE	Драйвер должен заполнить член dwEventHandlingState .
STI_DEVSTATUS_ONLINE_STATE	Драйвер должен заполнить член dwOnlineState .

dwOnlineState

Битовые флаги, указывающие текущее состояние устройства. Следующие флаги определены в Sti.h.

В настоящее время требуется использование STI_ONLINESTATE_OPERATIONAL, а все остальные флаги являются необязательными. (В настоящее время STI_ONLINESTATE_OPERATIONAL является единственным флагом, который проверяет сервер образа.)

STI_ONLINESTATE_BUSY

Устройство занято.

STI_ONLINESTATE_ERROR

Устройство сообщило об ошибке.

STI_ONLINESTATE_INITIALIZING

Устройство инициализируется.

STI_ONLINESTATE_IO_ACTIVE

Устройство активно, но не принимает команды.

STI_ONLINESTATE_OFFLINE

Устройство находится в автономном режиме.

STI_ONLINESTATE_OPERATIONAL

Устройство подключено и готово. Если этот параметр задан, панель управления указывает, что устройство готово. В противном случае это означает, что устройство не работает.

STI_ONLINESTATE_PAPER_JAM

Устройство сообщило о пробке бумаги.

STI_ONLINESTATE_PAPER_PROBLEM

Устройство сообщило о проблеме с неуказанным документом.

STI_ONLINESTATE_PAUSED

Устройство приостановлено.

STI_ONLINESTATE_PENDING

Операции ввода-вывода находятся в состоянии ожидания.

STI_ONLINESTATE_POWER_SAVE

Устройство находится в режиме экономии энергии.

STI_ONLINESTATE_TRANSFERRING

Устройство передает данные.

STI_ONLINESTATE_USER_INTERVENTION

Устройство требует вмешательства пользователя.

STI_ONLINESTATE_WARMING_UP

Устройство прогревается.

dwHardwareStatusCode

Необязательное значение конкретного устройства, определенное поставщиком.

dwEventHandlingState

Содержит битовые флаги, указывающие состояние события. Следующие флаги определены в Sti.h.

STI_EVENTHANDLING_ENABLED

Не используется.

STI_EVENTHANDLING_PENDING

Произошло событие устройства.

STI_EVENTHANDLING_POLLING