Método IWiaDevMgr2::RegisterEventCallbackInterface

Registra una aplicación en ejecución para la notificación de eventos de adquisición de imágenes de Windows (WIA) 2.0.

Sintaxis

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

Parámetros

lFlags [in]

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

bstrDeviceID [in]

Tipo: BSTR

Especifica el identificador único de un dispositivo WIA 2.0. Establezca este parámetro en NULL para registrarse para el evento en todos los dispositivos WIA 2.0.

pEventGUID [in]

Tipo: GUID const*

Especifica un puntero al identificador de evento para el que se registra la aplicación. Consulte Identificadores de eventos de WIA para conocer los identificadores de eventos estándar.

pIWiaEventCallback [in]

Tipo: IWiaEventCallback*

Especifica un puntero a la interfaz IWiaEventCallback que usa WIA 2.0 para enviar notificaciones de eventos.

pEventObject [out]

Tipo: IUnknown**

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

Valor devuelto

Tipo: HRESULT

Devuelve los códigos de error COM estándar o los siguientes.

Código devuelto	Descripción
E_NOTIMPL	No se puede devolver la interfaz IUnknown .

 

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 las aplicaciones WIA 2.0 comienzan a ejecutarse, usan este método para registrarse para recibir eventos de dispositivo de hardware. Esto impide que la aplicación se reinicie cuando se produce otro evento para el que se registra. Una vez que una aplicación llama a IWiaDevMgr2::RegisterEventCallbackInterface para registrarse para recibir eventos WIA 2.0 desde un dispositivo, los eventos registrados se enrutan al programa mediante WIA 2.0.

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro pEventObject .

Nota

En una aplicación multiproceso, la devolución de llamada de notificación de eventos puede aparecer en un subproceso diferente del que registró la devolución de llamada.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl