wiasQueueEvent 函数 (wiamdef.h)

wiasQueueEvent 函数通知服务设备生成事件。

语法

HRESULT wiasQueueEvent(
  [in]           BSTR       bstrDeviceId,
  [in]           const GUID *pEventGUID,
  [in, optional] BSTR       bstrFullItemName
);

参数

[in] bstrDeviceId

指定设备 ID。 这是在调用 IWiaMiniDrv::d rvInitializeWia 方法时传递给微型驱动程序的值。

[in] pEventGUID

指向包含事件的 GUID 的缓冲区的指针。

[in, optional] bstrFullItemName

指定完整项名称,包括路径信息。

返回值

成功后,该函数将返回S_OK。

如果函数失败,它将返回标准 COM 错误或 WIA 错误代码之一

言论

每当设备必须指示发生某种类型的事件时,都应使用此方法。 设备通过将事件置于事件队列中来执行此作。 例如,当相机拍摄新图片时,它应在将新驱动程序项添加到树后生成WIA_EVENT_ITEM_CREATED事件。 相机可以将此事件以这种方式放置在事件队列上:

hr = wiasQueueEvent(bstrMyDeviceId,
                    &WIA_EVENT_ITEM_CREATED,
                    bstrDescriptionString);

有关 WIA 事件标识符的完整列表,请参阅 Windows SDK 文档。

要求

要求 价值
目标平台 桌面
标头 wiamdef.h (包括 Wiamdef.h)
Wiaservc.lib
DLL Wiaservc.dll

另请参阅

IWiaMiniDrv::d rvInitializeWia