IStillImageW::EnableHwNotifications 方法 (sti.h)
IStillImage::EnableHwNotifications 方法會要求仍然影像事件監視器,以在指定裝置發生「仍然影像裝置事件」時啟用或停用應用程式的通知。
語法
HRESULT EnableHwNotifications(
[in] LPCWSTR pwszDeviceName,
BOOL bNewState
);
參數
[in] pwszDeviceName
呼叫端提供的字串指標,代表內部裝置名稱,藉由呼叫 IStillImage::GetSTILaunchInformation 或 IStillImage::GetDeviceList 取得。
bNewState
呼叫端提供的值,設定為 TRUE 以啟用通知,並將 FALSE 停用。
傳回值
如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
IStillImage::EnableHwNotifications 方法會啟用或停用所有應用程式的仍然影像裝置事件的通知,而不只是針對呼叫的應用程式。 默認會啟用事件通知。 這個方法適用於攔截來自裝置的事件並重新路由傳送的事件的應用程式。
在呼叫 IStillImage::EnableHwNotifications 之前, IStillImage COM 介面的客戶端必須呼叫 IStillImage::StiCreateInstance 以取得 IStillImage 介面指標。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sti.h (包含 Sti.h) |