STI_DEVICE_STATUS 结构 (sti.h)

项目
02/29/2024

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