Notifications matérielles

Windows fournit une infrastructure pour la 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 assurée par l’introduction d’une extension de classe Kernel-Mode Driver Framework (KMDF) 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, similaire à 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 la fonction KMDF, consultez Utilisation de WDF pour développer un pilote.

Pour assurer la prise en charge des notifications matérielles, vous avez besoin des éléments suivants :

• hwnclx.h

Énumérations

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

Fonctions

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 est 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 annule l’initialisation du composant de notification matérielle.
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 de périphérique 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é.

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 le pilote de périphérique client fournit.
HWN_CLIENT_REGISTRATION_PACKET Paquet d’inscription du 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 de pilote client.