Fonction NmrRegisterClient (netioddk.h)
La fonction NmrRegisterClient inscrit un module client avec la RMN.
Syntaxe
NTSTATUS NmrRegisterClient(
[in] PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
[in] __drv_aliasesMem PVOID ClientContext,
[out] PHANDLE NmrClientHandle
);
Paramètres
[in] ClientCharacteristics
Pointeur vers un NPI_CLIENT_CHARACTERISTICS structure qui décrit les caractéristiques du module client. Le module client doit s’assurer que cette structure reste valide et qu’elle réside dans la mémoire tant que le module client est inscrit auprès de la RMN.
[in] ClientContext
Pointeur vers un contexte fourni par l’appelant pour l’inscription. Le module client utilise ce contexte pour suivre l’état de l’inscription du client. Le contenu du contexte d’inscription du module client est opaque pour la RMN. La RMN transmet ce pointeur au module client chaque fois qu’elle appelle la fonction de rappel ClientAttachProvider du module client. Le module client doit s’assurer que son contexte d’inscription reste valide et qu’il réside en mémoire tant que le module client est inscrit auprès de la RMN.
[out] NmrClientHandle
Pointeur vers une variable qui reçoit un handle utilisé par la RMN pour représenter l’inscription du module client. Le module client doit enregistrer ce handle et le passer en tant que paramètre à la fonction NmrDeregisterClient lorsqu’il se désinscrit de la NMR.
Valeur retournée
La fonction NmrRegisterClient retourne l’un des codes NTSTATUS suivants :
Code de retour | Description |
---|---|
|
La RMN a correctement inscrit le module client. |
|
Le NMR ne disposait pas de ressources système suffisantes pour inscrire le module client. |
|
Une erreur est survenue. |
Remarques
Un module client appelle la fonction NmrRegisterClient pour s’inscrire en tant que client d’un NPI afin qu’il puisse l’attacher à des modules de fournisseur qui s’inscrivent en tant que fournisseurs du même NPI.
Un module client appelle généralement la fonction NmrRegisterClient à partir de sa fonction DriverEntry après avoir effectué toutes les autres tâches d’initialisation. L’appel à la fonction NmrRegisterClient indique au NMR que le module client est prêt à attacher à tous les modules de fournisseur qui ont inscrit ou s’inscrivent en tant que fournisseurs du même NPI pour lequel le module client s’est inscrit en tant que client.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | netioddk.h (inclure Wsk.h) |
Bibliothèque | Netio.lib |
IRQL | PASSIVE_LEVEL |