IStiUSD::GetStatus 方法 (stiusd.h)

静止图像微型驱动程序的 IStiUSD::GetStatus 方法返回静止图像设备的状态。

语法

HRESULT GetStatus(
  PSTI_DEVICE_STATUS pDevStatus
);

参数

pDevStatus

调用方提供的指向 STI_DEVICE_STATUS 结构的指针。

返回值

如果操作成功,该方法应返回S_OK。 否则,它应返回 stierr.h 中定义的以 STIERR 为前缀的错误代码之一。

注解

调用方为 STI_DEVICE_STATUS 结构的 dwSizeStatusMask 成员提供值,微型驱动程序必须为结构的其余成员提供值。

如果驱动程序以前在设备的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)

另请参阅

IStiDevice::GetStatus

IStiUSD