共用方式為


(stiusd.h) IStiUSD::GetStatus 方法

仍然影像迷你驅動程式的 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