Compartir a través de

Método IWiaDevMgr::RegisterEventCallbackInterface (wia_xp.h)

  • Artículo

El método IWiaDevMgr::RegisterEventCallbackInterface registra una notificación de eventos de adquisición de imágenes de Windows (WIA) de aplicación en ejecución.

Sintaxis

HRESULT RegisterEventCallbackInterface(
  [in]  LONG              lFlags,
  [in]  BSTR              bstrDeviceID,
  [in]  const GUID        *pEventGUID,
  [in]  IWiaEventCallback *pIWiaEventCallback,
  [out] IUnknown          **pEventObject
);

Parámetros

[in] lFlags

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

[in] bstrDeviceID

Tipo: BSTR

Especifica un identificador de dispositivo. Pase NULL para registrarse para el evento en todos los dispositivos WIA.

[in] pEventGUID

Tipo: GUID const*

Especifica el evento para el que se registra la aplicación. Para obtener una lista de eventos estándar, consulte Identificadores de eventos WIA.

[in] pIWiaEventCallback

Tipo: IWiaEventCallback*

Puntero a la interfaz IWiaEventCallback que el sistema WIA usó para enviar la notificación de eventos.

[out] pEventObject

Tipo: IUnknown**

Recibe la dirección de un puntero a la interfaz IUnknown .

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

Advertencia El uso de los métodos IWiaDevMgr::RegisterEventCallbackInterface, IWiaDevMgr2::RegisterEventCallbackInterface y DeviceManager.RegisterEvent del mismo proceso después de reiniciar el servicio Still Image puede provocar una infracción de acceso, si las funciones se usaron antes de que se detenga el servicio.
 
Cuando comienzan a ejecutarse, las aplicaciones WIA usan este método para registrarse para recibir eventos de dispositivo de hardware del tipo WIA_NOTIFICATION_EVENT. Esto impide que la aplicación se reinicie cuando se produce otro evento para el que se registra. Una vez que un programa invoca IWiaDevMgr::RegisterEventCallbackInterface para registrarse para recibir eventos WIA de un dispositivo, los eventos registrados se enrutan al programa mediante el sistema WIA.

Las aplicaciones usan el método EnumRegisterEventInfo para recuperar un puntero a un objeto enumerador para las propiedades de registro de eventos.

Una aplicación puede encontrar si un evento es un tipo de acción o un tipo de notificación (o ambos) examinando el valor ulFlags de una estructura WIA_DEV_CAP devuelta por la enumeración de eventos.

Las aplicaciones pueden anular el registro de eventos mediante el puntero IUnknown devuelto a través del parámetro pEventObject para llamar al método IUnknown::Release .

Nota En una aplicación multiproceso, no hay ninguna garantía de que la devolución de llamada de notificación de eventos se incluirá en el mismo subproceso que registró la devolución de llamada.
 

Requisitos

Requisito Value
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 (incluya Wia.h)
Library Wiaguid.lib
Archivo DLL Wiaservc.dll