Compartir a través de

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

  • Artículo

El método IWiaDevMgr::RegisterEventCallbackCLSID registra una aplicación para recibir eventos aunque la aplicación no se esté ejecutando.

Sintaxis

HRESULT RegisterEventCallbackCLSID(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] const GUID *pClsID,
  [in] BSTR       bstrName,
  [in] BSTR       bstrDescription,
  [in] BSTR       bstrIcon
);

Parámetros

[in] lFlags

Tipo: LONG

Especifica marcas de registro. Se puede establecer en los valores siguientes:

Marca de registro Significado
WIA_REGISTER_EVENT_CALLBACK Registrarse para el evento.
WIA_UNREGISTER_EVENT_CALLBACK Elimine el registro del evento.
WIA_SET_DEFAULT_HANDLER Establezca la aplicación como el controlador de eventos predeterminado.

[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] pClsID

Tipo: GUID const*

Puntero al identificador de clase (CLSID) de la aplicación. El sistema en tiempo de ejecución de WIA usa el CLSID de la aplicación para iniciar la aplicación cuando se produce un evento para el que se registra.

[in] bstrName

Tipo: BSTR

Especifica el nombre de la aplicación que se registra para el evento.

[in] bstrDescription

Tipo: BSTR

Especifica una descripción de texto de la aplicación que se registra para el evento.

[in] bstrIcon

Tipo: BSTR

Especifica el nombre de un archivo de imagen que se va a usar para el icono de la aplicación que se registra para el evento.

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

Las aplicaciones WIA usan este método para registrarse para recibir eventos de dispositivo de hardware del tipo WIA_ACTION_EVENT. Una vez que los programas llaman a IWiaDevMgr::RegisterEventCallbackCLSID, se registran para recibir eventos de dispositivo WIA incluso si no se están ejecutando.

Cuando se produce el evento, el sistema WIA determina qué aplicación está registrada para recibir el evento. Usa la función CoCreateInstance y el identificador de clase especificado en el parámetro pClsID para crear una instancia de la aplicación. A continuación, llama al método ImageEventCallback de la aplicación para transmitir la información del evento.

Una aplicación puede invocar el método EnumRegisterEventInfo para enumerar la información 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.

Si la aplicación no es un componente del modelo de objetos componentes (COM) registrado y no es compatible con la arquitectura WIA, los desarrolladores deben usar IWiaDevMgr::RegisterEventCallbackProgram en lugar de este método.

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