estructura WIA_DEV_CAP_DRV (wiamindr_lh.h)
La estructura WIA_DEV_CAP_DRV se usa para enumerar las funcionalidades del dispositivo. Una funcionalidad del dispositivo se define mediante un evento o comando que admite el dispositivo.
Sintaxis
typedef struct _WIA_DEV_CAP_DRV {
GUID *guid;
ULONG ulFlags;
LPOLESTR wszName;
LPOLESTR wszDescription;
LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;
Miembros
guid
Apunta a un GUID que identifica la funcionalidad del dispositivo. Este miembro se puede establecer en cualquiera de los valores especificados para los comandos del dispositivo WIA (comandos WIA_CMD_XXX ) o identificadores de eventos WIA (WIA_EVENT_XXX identificadores de eventos). Para obtener más información, consulte Comandos de dispositivo WIA.
El controlador puede definir su propio GUID de funcionalidad que puede enviar al dispositivo. Sin embargo, una aplicación tendría que tener conocimientos específicos sobre esa funcionalidad para que pueda responder a la nueva funcionalidad. Normalmente, una aplicación reconoce solo los GUID de eventos y comandos WIA estándar (WIA_CMD_XXX y WIA_EVENT_XXX).
ulFlags
Especifica el tipo de evento. Este miembro se puede establecer en uno o ambos de los siguientes:
| Marca | Significado |
|---|---|
| WIA_ACTION_EVENT | La aplicación puede registrar una acción para el evento determinado mediante los métodos IWiaDevMgr::RegisterEventCallbackProgram e IwiaDevMgr::RegisterEventCallbackCLSID . Un evento de acción inicia la aplicación registrada para controlar este evento. |
| WIA_NOTIFICATION_EVENT | La aplicación puede registrarse para recibir notificaciones en el evento determinado mediante el método IwiaDevMgr::RegisterEventCallbackInterface . Un evento de notificación solo se envía a las aplicaciones que ya están en ejecución. |
wszName
Especifica una cadena que contiene una versión corta del nombre de la funcionalidad.
wszDescription
Especifica una cadena que contiene la versión del nombre de la funcionalidad que se puede mostrar al usuario.
wszIcon
Especifica una cadena que contiene el nombre del icono para esta funcionalidad. El icono se puede mostrar al usuario .
Comentarios
El servicio WIA llama a la función IWiaMiniDrv::d rvGetCapabilities del minidriver para rellenar los miembros de una estructura de WIA_DEV_CAP_DRV.
Cuando un controlador enumera controladores de eventos, el único valor válido es WIA_IS_DEFAULT_HANDLER; que indica que se debe usar el controlador registrado actualmente.
Requisitos
| Requisito | Valor |
|---|---|
| Header | wiamindr_lh.h (incluya Wiamindr.h) |