IWiaDevMgr2：：RegisterEventCallbackInterface 方法

註冊執行中應用程式以取得 Windows 映像 (WIA) 2.0 事件通知。

語法

HRESULT RegisterEventCallbackInterface(
  [in]        LONG              lFlags,
  [in]        BSTR              bstrDeviceID,
  [in]  const GUID              *pEventGUID,
  [in]        IWiaEventCallback *pIWiaEventCallback,
  [out]       IUnknown          **pEventObject
);

參數

lFlags [in]

類型： LONG

目前未使用。 應該設定為零。

bstrDeviceID [in]

類型： BSTR

指定 WIA 2.0 裝置的唯一識別碼。 將此參數設定為 Null ，以在所有 WIA 2.0 裝置上註冊事件。

pEventGUID [in]

類型： const GUID*

指定應用程式所註冊之事件識別碼的指標。 如需標準 事件識別碼，請參閱 WIA 事件識別碼 。

pIWiaEventCallback [in]

類型： IWiaEventCallback*

指定 WIA 2.0 用來傳送事件通知的 IWiaEventCallback 介面指標。

pEventObject [out]

類型： IUnknown**

接收 IUnknown 介面指標的位址。

傳回值

類型： HRESULT

傳回標準 COM 錯誤碼或下列專案。

傳回碼	描述
E_NOTIMPL	無法傳回 IUnknown 介面。

 

備註

警告

如果在服務停止之前使用相同進程的 IWiaDevMgr：：RegisterEventCallbackInterface、 IWiaDevMgr2：：RegisterEventCallbackInterface和 DeviceManager.RegisterEvent 方法，可能會導致存取違規。

 

當 WIA 2.0 應用程式開始執行時，他們會使用此方法註冊來接收硬體裝置事件。 這可防止應用程式在註冊應用程式的另一個事件發生時重新開機。 一旦應用程式呼叫 IWiaDevMgr2：：RegisterEventCallbackInterface 來註冊本身以接收來自裝置的 WIA 2.0 事件，已註冊的事件就會由 WIA 2.0 路由傳送至程式。

應用程式必須在透過pEventObject參數接收的介面指標上呼叫IUnknown：：Release方法。

注意

在多執行緒應用程式中，事件通知回呼可能會與註冊回呼的執行緒不同。

 

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	Wia.h
Idl	Wia.idl