IStiUSD::GetStatus 方法 (stiusd.h)
靜止影像 minidriver 的 IStiUSD::GetStatus 方法會傳回仍存映像裝置的狀態。
語法
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
參數
pDevStatus
呼叫端提供的 STI_DEVICE_STATUS 結構的指標。
傳回值
如果作業成功,方法應該會傳回S_OK。 否則,它應該傳回 stierr.h 中定義的其中一個 STIERR 前置詞錯誤碼。
言論
呼叫端會提供 dwSize 和 StatusMaskSTI_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) |