Compartir a través de

Método IWiaEventCallback::ImageEventCallback (wia_xp.h)

  • Artículo

El sistema en tiempo de ejecución de Adquisición de imágenes de Windows (WIA) invoca el método IWiaEventCallback::ImageEventCallback cuando se produce un evento de dispositivo de hardware.

Sintaxis

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
);

Parámetros

[in] pEventGUID

Tipo: GUID const*

Especifica el identificador único del evento. Para obtener una lista completa de los eventos de dispositivo, consulte Identificadores de eventos wia.

[in] bstrEventDescription

Tipo: BSTR

Especifica la descripción de cadena del evento.

[in] bstrDeviceID

Tipo: BSTR

Especifica el identificador único del dispositivo WIA.

[in] bstrDeviceDescription

Tipo: BSTR

Especifica la descripción de cadena del dispositivo.

[in] dwDeviceType

Tipo: DWORD

Especifica el tipo del dispositivo. Consulte Especificadores de tipo de dispositivo WIA para obtener una lista de los valores posibles.

[in] bstrFullItemName

Tipo: BSTR

Especifica el nombre completo del elemento WIA que representa el dispositivo.

[in, out] pulEventType

Tipo: ULONG*

Puntero a un ULONG que especifica si un evento es un evento de notificación, un evento de acción o ambos. Un valor de 1 indica un evento de notificación, un valor de 2 indica un evento de acción y un valor de 3 indica que el evento es de tipo de notificación y acción.

[in] ulReserved

Tipo: ULONG

Reservado para la información del usuario.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para recibir notificaciones de eventos de dispositivo de hardware WIA, las aplicaciones pasan un puntero a la interfaz IWiaEventCallback al método RegisterEventCallbackInterface . A continuación, el sistema en tiempo de ejecución de WIA usa ese puntero de interfaz para invocar el método IWiaEventCallback::ImageEventCallback cada vez que se produce un evento de dispositivo de hardware WIA.

Tenga en cuenta que no hay ninguna garantía de que la devolución de llamada se invocará en el mismo subproceso que registró la interfaz IWiaEventCallback .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluye Wia.h)
Library Wiaguid.lib