Fonction HwNRegisterClient (hwnclx.h)

  • Article

Inscrit le pilote client de notification matérielle et ses fonctions de rappel avec l’extension de classe. Cette fonction doit être appelée lorsque le pilote client est chargé et que la routine DriverEntry est appelée pour l’initialisation.

Syntaxe

FORCEINLINE NTSTATUS  HwNRegisterClient(
  _In_    WDFDRIVER                        Driver,
  _Inout_ PHWN_CLIENT_REGISTRATION_PACKET  RegistrationPacket,
  _In_    PUNICODE_STRING                  RegistryPath
);

Paramètres

[in] Driver

Gérez l’objet pilote d’infrastructure des pilotes clients.

[in, out] RegistrationPacket

Pointeur vers la structure HWN_CLIENT_REGISTRATION_PACKET qui contient des pointeurs de fonction vers les fonctions de rappel définies dans l’implémentation du pilote client et requises par l’extension de classe.

[in] RegistryPath

Pointeur vers une structure UNICODE_STRING qui contient le chemin d’accès à la clé de Registre du pilote client.

Valeur retournée

Retourne STATUS_SUCCESS si la fonction réussit. Retourne STATUS_INVALID_PARAMETER si le pilote client correspondant est introuvable. Sinon, il retourne l’une des valeurs d’erreur status définies dans Ntstatus.h.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête hwnclx.h
Bibliothèque Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

Voir aussi

Prise en charge des notifications matérielles

Informations de référence sur les notifications matérielles