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 :

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

Voir aussi

DriverEntry

NPI_CLIENT_CHARACTERISTICS

NmrDeregisterClient