共用方式為


IStiUSD::GetStatus 方法 (stiusd.h)

靜止影像 minidriver 的 IStiUSD::GetStatus 方法會傳回仍存映像裝置的狀態。

語法

HRESULT GetStatus(
  PSTI_DEVICE_STATUS pDevStatus
);

參數

pDevStatus

呼叫端提供的 STI_DEVICE_STATUS 結構的指標。

傳回值

如果作業成功,方法應該會傳回S_OK。 否則,它應該傳回 stierr.h 中定義的其中一個 STIERR 前置詞錯誤碼。

言論

呼叫端會提供 dwSizeStatusMaskSTI_DEVICE_STATUS 結構成員的值,而minidriver必須提供其餘結構成員的值。

如果驅動程式先前已在裝置 STI_DEV_CAPS 結構中設定STI_GENCAP_POLLING_NEEDED旗標,minidriver 的 IStiUSD::GetStatus 方法就是事件監視器判斷是否發生 仍然影像裝置事件 的方法。 事件監視器會呼叫 方法,並在提供的 STI_DEVICE_STATUS 結構中指定STI_DEVSTATUS_EVENT_STATE。 驅動程式必須輪詢裝置,並在事件發生時設定STI_EVENTHANDLING_PENDING。

如果呼叫端在提供的 STI_DEVICE_STATUS 結構中指定STI_DEVSTATUS_ONLINE_STATE,minidriver 應該在結構的 dwOnlineState 成員中設定適當的旗標。

要求

要求 價值
目標平臺 桌面
標頭 stiusd.h (包括 Stiusd.h)

另請參閱

IStiDevice::GetStatus

IStiUSD