IStiUSD::SetNotificationHandle 方法 (stiusd.h)
仍然影像 minidriver 的 IStiUSD::SetNotificationHandle 方法會指定迷你驅動程式應該用來通知裝置事件的呼叫端的事件句柄。
語法
HRESULT SetNotificationHandle(
HANDLE hEvent
);
參數
hEvent
由呼叫 CreateEvent 所建立之 Win32 事件的呼叫端提供句柄。
傳回值
如果作業成功,方法應該會傳回S_OK。 否則,它應該會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
如果驅動程式 (和裝置) 支援 仍然映像裝置事件的異步通知,迷你驅動程式的 IStiUSD::SetNotificationHandle 方法是事件監視器要求驅動程式在事件發生時通知它的方法。
如果 hEvent 是事件句柄,IStiUSD::SetNotificationHandle 方法應該儲存句柄,並將其作為 SetEvent (的輸入自變數,Microsoft Windows SDK 檔) 中所述。 驅動程式應該在每次偵測到裝置事件時呼叫 SetEvent ,以通知事件監視器已發生事件。
如果 hEvent 為 NULL,此方法應該停用裝置事件的通知。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | stiusd.h (包含 Stiusd.h) |