(stiusd.h) IStiUSD::GetStatus 方法
仍然影像迷你驅動程式的 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) |