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文档。

要求

另请参阅

IWiaMiniDrv：:d rvInitializeWia