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

Метод IWiaEventCallback::ImageEventCallback (wia_xp.h)

  • Статья

Метод IWiaEventCallback::ImageEventCallback вызывается системой времени выполнения windows Image Acquisition (WIA) при возникновении события аппаратного устройства.

Синтаксис

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 , указывающий, является ли событие событием уведомления, событием действия или и тем, и другим. Значение 1 указывает на событие уведомления, значение 2 — событие действия, а значение 3 указывает на то, что событие относится к типу уведомления и действия.

[in] ulReserved

Тип: ULONG

Зарезервировано для сведений о пользователе.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Чтобы получать уведомления о событиях аппаратного устройства WIA, приложения передают указатель на интерфейс IWiaEventCallback в метод RegisterEventCallbackInterface . Затем система времени выполнения WIA использует этот указатель интерфейса для вызова метода IWiaEventCallback::ImageEventCallback при каждом возникновении события аппаратного устройства WIA.

Обратите внимание, что нет никакой гарантии, что обратный вызов будет вызван в том же потоке, который зарегистрировал интерфейс IWiaEventCallback .

Требования

   
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wia_xp.h (включая Wia.h)
Библиотека Wiaguid.lib