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

Статья
02/07/2025

Структура 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