Partager via


en-tête hwnclx.h

Cet en-tête définit les interfaces de programmation requises pour fournir une prise en charge matérielle des composants de notification tels que les LED et les mécanismes de vibration. Cette prise en charge est fournie via l’introduction d’une extension de classe KMDF (Kernel-Mode Driver Framework) spécifiquement pour les composants de notification matérielle qui permettent 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 kmDF, consultez

Pour plus d’informations, consultez :

  • 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 après l’appel de la fonction de rappel EVT_WDF_DRIVER_DEVICE_ADD du pilote client et l’objet d’appareil a été créé.
HwNProcessAddDevicePreDeviceCreate

Fournit les rappels de préparation/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. Elle est appelée lorsqu’un utilisateur demande des informations d’état.
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. Elle est appelée 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 TO 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 le pilote de périphérique client fournit.
HWN_CLIENT_REGISTRATION_PACKET

Paquet d’inscription de pilote client notification matérielle transmis à l’extension de classe lorsqu’un pilote client est inscrit. Contient des informations de version et des fonctions de rappel de 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.