IStiUSD::GetStatus 方法 (stiusd.h)
静止图像微型驱动程序的 IStiUSD::GetStatus 方法返回静止图像设备的状态。
语法
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
参数
pDevStatus
调用方提供的指向 STI_DEVICE_STATUS 结构的指针。
返回值
如果操作成功,该方法应返回S_OK。 否则,它应返回 stierr.h 中定义的以 STIERR 为前缀的错误代码之一。
注解
调用方为 STI_DEVICE_STATUS 结构的 dwSize 和 StatusMask 成员提供值,微型驱动程序必须为结构的其余成员提供值。
如果驱动程序以前在设备的STI_DEV_CAPS结构中设置了 STI_GENCAP_POLLING_NEEDED 标志,则微型驱动程序的 IStiUSD::GetStatus 方法是事件监视器确定 是否发生了静止图像设备事件 的方法。 事件监视器将调用 方法,并在提供的 STI_DEVICE_STATUS 结构中指定 STI_DEVSTATUS_EVENT_STATE 。 如果发生事件,驱动程序必须轮询设备并设置STI_EVENTHANDLING_PENDING。
如果调用方在提供的 STI_DEVICE_STATUS 结构中指定STI_DEVSTATUS_ONLINE_STATE,微型驱动程序应在结构的 dwOnlineState 成员中设置相应的标志。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | stiusd.h (包括 Stiusd.h) |