Compartir a través de


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:

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.