IWiaDevMgr2：：RegisterEventCallbackProgram 方法

IWiaDevMgr2：：RegisterEventCallbackProgram 方法注册应用程序以接收设备事件。 它主要用于向后兼容不是为 Windows 映像采集 (WIA) 2.0 编写的应用程序。

语法

HRESULT RegisterEventCallbackProgram(
  [in]       LONG lFlags,
  [in]       BSTR bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in]       BSTR bstrFullAppName,
  [in]       BSTR bstrCommandlineArg,
  [in]       BSTR bstrName,
  [in]       BSTR bstrDescription,
  [in]       BSTR bstrIcon
);

参数

lFlags [in]

类型： LONG

注册标志。 可以设置为以下值。

值	含义
WIA_REGISTER_EVENT_CALLBACK	报名参加活动。
WIA_UNREGISTER_EVENT_CALLBACK	删除事件的注册。
WIA_SET_DEFAULT_HANDLER	将应用程序设置为默认事件处理程序。

 

bstrDeviceID [in]

类型： BSTR

设备标识符。 传递 NULL 以在所有 WIA 2.0 设备上注册事件。

pEventGUID [in]

类型： const GUID*

应用程序正在注册的事件。 有关有效事件 GUID 的列表，请参阅 WIA 事件标识符。

bstrFullAppName [in]

类型： BSTR

应用程序的完整路径名称。

bstrCommandlineArg [in]

类型： BSTR

应用程序的相应命令行参数。

bstrName [in]

类型： BSTR

应用程序的名称。 当多个应用程序注册同一事件时，该名称会显示给用户。

bstrDescription [in]

类型： BSTR

应用程序的说明。 当多个应用程序注册同一事件时，向用户显示说明。

bstrIcon [in]

类型： BSTR

表示应用程序的图标。 当多个应用程序注册同一事件时，向用户显示该图标。 字符串包含应用程序的名称和图标的从零开始的索引，用逗号分隔，例如“MyApp，0”。 可能有多个表示应用程序的图标。

返回值

类型： HRESULT

如果此方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

备注

使用 IWiaDevMgr2：：RegisterEventCallbackProgram 注册硬件设备事件。 发生应用程序注册到的事件时，将启动应用程序，并将事件信息传输到应用程序。

使用 EnumRegisterEventInfo 方法检索指向事件注册属性的枚举器对象的指针。

仅使用 IWiaDevMgr2：：RegisterEventCallbackProgram 方法与未为 WIA 2.0 体系结构编写的应用程序向后兼容。 使用组件对象模型 (COM) WIA 2.0 体系结构为新应用程序提供的接口。 具体而言，调用 IWiaDevMgr2：：RegisterEventCallbackInterface 或 IWiaDevMgr2：：RegisterEventCallbackCLSID 为设备事件注册新应用程序。

通常，此方法由安装程序或脚本调用。 安装程序或脚本注册应用程序以接收 WIA 2.0 设备事件。 事件发生时，应用程序由 WIA 2.0 运行时系统启动。

要求