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

I/O作挂起。

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