IWiaEventCallback：：ImageEventCallback 方法 (wia_xp.h)

发生硬件设备事件时，Windows 映像采集 (WIA) 运行时系统调用 IWiaEventCallback：：ImageEventCallback 方法。

语法

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

参数

[in] pEventGUID

类型： const GUID*

指定事件的唯一标识符。 有关设备事件的完整列表，请参阅 WIA 事件标识符。

[in] bstrEventDescription

类型： BSTR

指定事件的字符串说明。

[in] bstrDeviceID

类型： BSTR

指定 WIA 设备的唯一标识符。

[in] bstrDeviceDescription

类型： BSTR

指定设备的字符串说明。

[in] dwDeviceType

类型：DWORD

指定设备的类型。 有关可能值的列表，请参阅 WIA 设备类型说明符 。

[in] bstrFullItemName

类型： BSTR

指定表示设备的 WIA 项的全名。

[in, out] pulEventType

类型： ULONG*

指向 ULONG 的指针，该 ULONG 指定事件是通知事件、操作事件还是两者兼有。 值 1 指示通知事件，值 2 指示操作事件，值 3 指示事件为通知和操作类型。

[in] ulReserved

类型： ULONG

为用户信息保留。

返回值

类型： HRESULT

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

注解

为了接收 WIA 硬件设备事件的通知，应用程序会将指向 IWiaEventCallback 接口的指针传递给 RegisterEventCallbackInterface 方法。 然后，每当发生 WIA 硬件设备事件时，WIA 运行时系统使用该接口指针调用 IWiaEventCallback：：ImageEventCallback 方法。

请注意，不能保证将在注册 IWiaEventCallback 接口的同一线程上调用回调。

要求