IWiaDevMgr2：：RegisterEventCallbackInterface 方法

  • 项目

(WIA) 2.0 事件通知注册运行中的 Windows 映像获取应用程序。

语法

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