функция wiasQueueEvent (wiamdef.h)

Статья
02/07/2025

Функция wiasQueueEvent сообщает службе, что устройство создало событие.

Синтаксис

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

Параметры

[in] bstrDeviceId

Указывает идентификатор устройства. Это значение, переданное мини-driver в вызове метода 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 см. в документации по пакету SDK для Windows.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	wiamdef.h (включая Wiamdef.h)
библиотеки	Wiaservc.lib
DLL	Wiaservc.dll

См. также

IWiaMiniDrv::d rvInitializeWia

Поделиться через