Encabezado hwnclx.h

Este encabezado define las interfaces de programación necesarias para proporcionar compatibilidad independiente del hardware de componentes de notificación, como LED y mecanismos de vibración. Esta compatibilidad se entrega a través de la introducción de una extensión de clase de Kernel-Mode Driver Framework (KMDF) específicamente para los componentes de notificación de hardware que permiten el desarrollo rápido de controladores de cliente. Una extensión de clase KMDF es básicamente un controlador KMDF que proporciona un conjunto definido de funcionalidad para una clase determinada de dispositivos, similar a un controlador de puerto en el modelo de controlador de Windows (WDM). En esta sección se proporciona información general sobre la arquitectura de la extensión de clase de notificación de hardware. Para obtener más información sobre kmdf, consulte

Para más información, consulte:

• Guía de diseño de notificaciones de hardware

hwnclx.h contiene las siguientes interfaces de programación:

Functions

HwNProcessAddDevicePostDeviceCreate Crea colas de E/S. Se debe llamar después de que se invoque la función de devolución de llamada del controlador de cliente EVT_WDF_DRIVER_DEVICE_ADD y se haya creado el objeto de dispositivo.
HwNProcessAddDevicePreDeviceCreate Proporciona las devoluciones de llamada de entrada y salida y preparación del dispositivo a Windows Driver Foundation (WDF) para realizar la transición del dispositivo a diferentes estados.
HwNRegisterClient Registra el controlador cliente de notificaciones de hardware y sus funciones de devolución de llamada con la extensión de clase .
HwNUnregisterClient Anula el registro del controlador de cliente de notificaciones de hardware y sus funciones de devolución de llamada con la extensión de clase . Esta función se debe invocar cuando se descarga el controlador cliente.

Funciones de devolución de llamada

HWN_CLIENT_GET_STATE Implementado por el controlador cliente para obtener el estado del componente de notificación de hardware. Se invoca cuando un usuario solicita información de estado.
HWN_CLIENT_INITIALIZE_DEVICE Implementado por el controlador de cliente y se invoca como resultado de una llamada a EVT_WDF_DEVICE_PREPARE_HARDWARE.
HWN_CLIENT_QUERY_DEVICE_INFORMATION Implementado por el controlador de cliente para recuperar atributos de componente de notificación de hardware.
HWN_CLIENT_SET_STATE Implementado por el controlador cliente para establecer el estado del componente de notificación de hardware. Se invoca cuando un usuario quiere cambiar el estado de un controlador.
HWN_CLIENT_START_DEVICE Implementado por el controlador cliente para iniciar el componente de notificación de hardware. Se invoca como resultado de una llamada a EVT_WDF_DEVICE_D0_ENTRY.
HWN_CLIENT_STOP_DEVICE Implementado por el controlador de cliente PARA iniciar el componente de notificación de hardware. Se invoca como resultado de una llamada a EVT_WDF_DEVICE_D0_EXIT.
HWN_CLIENT_UNINITIALIZE_DEVICE Implementado por el controlador de cliente e invocado como invocado como resultado de una llamada a EVT_WDF_DEVICE_RELEASE_HARDWARE. Esta función de devolución de llamada anula la inicialización del componente de notificación de hardware.

Estructuras

CLIENT_DEVICE_INFORMATION La CLIENT_DEVICE_INFORMATION estructura se usa en la devolución de llamada de notificación de hardware HWN_CLIENT_QUERY_DEVICE_INFORMATION para devolver el número total de notificaciones de hardware que proporciona el controlador de dispositivo cliente.
HWN_CLIENT_REGISTRATION_PACKET Paquete de registro de controladores de cliente de notificación de hardware que se pasa a la extensión de clase cuando se registra un controlador de cliente. Contiene información de versión y funciones de devolución de llamada del controlador de cliente.

Enumeraciones

HWN_CLX_EXPORT_INDEX Define la posición de cada una de las exportaciones de notificación de hardware en la tabla de exportación.