en-tête hwnclx.h

Cet en-tête définit les interfaces de programmation nécessaires pour fournir une prise en charge indépendante du matériel des composants de notification tels que les LED et les mécanismes de vibration. Cette prise en charge est fournie par l’introduction d’une extension de classe KMDF (Kernel-Mode Driver Framework) spécifiquement pour les composants de notification matérielle qui permet le développement rapide des pilotes clients. Une extension de classe KMDF est essentiellement un pilote KMDF qui fournit un ensemble défini de fonctionnalités pour une classe donnée d’appareils, comme un pilote de port dans le modèle de pilote Windows (WDM). Cette section fournit une vue d’ensemble de l’architecture de l’extension de classe de notification matérielle. Pour plus d’informations sur le KMDF, consultez

Pour plus d'informations, consultez les pages suivantes :

• Guide de conception des notifications matérielles

hwnclx.h contient les interfaces de programmation suivantes :

Fonctions

HwNProcessAddDevicePostDeviceCreate Crée des files d’attente d’E/S. Elle doit être appelée une fois que la fonction de rappel EVT_WDF_DRIVER_DEVICE_ADD du pilote client a été appelée et que l’objet d’appareil a été créé.
HwNProcessAddDevicePreDeviceCreate Fournit les rappels de préparation/de mise en production et d’entrée/sortie de l’appareil à Windows Driver Foundation (WDF) pour la transition de l’appareil dans différents états.
HwNRegisterClient Inscrit le pilote client de notification matérielle et ses fonctions de rappel avec l’extension de classe.
HwNUnregisterClient Annule l’inscription du pilote client de notification matérielle et de ses fonctions de rappel avec l’extension de classe. Cette fonction doit être appelée lorsque le pilote client est déchargé.

Fonctions de rappel

HWN_CLIENT_GET_STATE Implémenté par le pilote client pour obtenir l’état du composant de notification matérielle. Il est appelé lorsqu’un utilisateur demande status informations.
HWN_CLIENT_INITIALIZE_DEVICE Implémenté par le pilote client et appelé à la suite d’un appel à EVT_WDF_DEVICE_PREPARE_HARDWARE.
HWN_CLIENT_QUERY_DEVICE_INFORMATION Implémenté par le pilote client pour récupérer les attributs du composant de notification matérielle.
HWN_CLIENT_SET_STATE Implémenté par le pilote client pour définir l’état du composant de notification matérielle. Il est appelé lorsqu’un utilisateur souhaite modifier l’état d’un pilote.
HWN_CLIENT_START_DEVICE Implémenté par le pilote client pour démarrer le composant de notification matérielle. Il est appelé à la suite d’un appel à EVT_WDF_DEVICE_D0_ENTRY.
HWN_CLIENT_STOP_DEVICE Implémenté par le pilote client POUR démarrer le composant de notification matérielle. Il est appelé à la suite d’un appel à EVT_WDF_DEVICE_D0_EXIT.
HWN_CLIENT_UNINITIALIZE_DEVICE Implémenté par le pilote client et appelé comme appelé à la suite d’un appel à EVT_WDF_DEVICE_RELEASE_HARDWARE. Cette fonction de rappel ne initialise pas le composant de notification matérielle.

Structures

CLIENT_DEVICE_INFORMATION La structure CLIENT_DEVICE_INFORMATION est utilisée par le rappel de notification matérielle HWN_CLIENT_QUERY_DEVICE_INFORMATION pour retourner le nombre total de notifications matérielles que fournit le pilote de périphérique client.
HWN_CLIENT_REGISTRATION_PACKET Paquet d’inscription de pilote client notification matérielle qui est passé à l’extension de classe lorsqu’un pilote client est inscrit. Contient des informations de version et des fonctions de rappel du pilote client.

Énumérations

HWN_CLX_EXPORT_INDEX Définit la position de chacune des exportations de notification matérielle dans la table d’exportation.