Fonction NmrRegisterProvider (netioddk.h)

  • Article

La fonction NmrRegisterProvider inscrit un module fournisseur avec la RMN.

Syntaxe

NTSTATUS NmrRegisterProvider(
  [in]  PNPI_PROVIDER_CHARACTERISTICS ProviderCharacteristics,
  [in]  __drv_aliasesMem PVOID        ProviderContext,
  [out] PHANDLE                       NmrProviderHandle
);

Paramètres

[in] ProviderCharacteristics

Pointeur vers un NPI_PROVIDER_CHARACTERISTICS structure qui décrit les caractéristiques du module fournisseur. Le module fournisseur doit s’assurer que cette structure reste valide et qu’elle réside dans la mémoire tant que le module fournisseur est inscrit auprès de la RMN.

[in] ProviderContext

Pointeur vers un contexte fourni par l’appelant pour l’inscription. Le module fournisseur utilise ce contexte pour effectuer le suivi de l’état de l’inscription du fournisseur. Le contenu du contexte d’inscription du module fournisseur est opaque pour la RMN. La RMN transmet ce pointeur au module fournisseur chaque fois qu’elle appelle la fonction de rappel ProviderAttachClient du module fournisseur. Le module fournisseur doit s’assurer que ce contexte reste valide et qu’il réside dans la mémoire tant que le module fournisseur est inscrit auprès de la RMN.

[out] NmrProviderHandle

Pointeur vers une variable qui reçoit un handle utilisé par la RMN pour représenter l’inscription du module fournisseur. Le module fournisseur doit enregistrer ce handle et le passer en tant que paramètre à la fonction NmrDeregisterProvider lorsqu’il se désinscrit de la NMR.

Valeur retournée

La fonction NmrRegisterProvider retourne l’un des codes NTSTATUS suivants :

Code de retour Description
STATUS_SUCCESS
 La RMN a correctement inscrit le module fournisseur.
STATUS_INSUFFICIENT_RESOURCES
 La RMN ne disposait pas de ressources système suffisantes pour inscrire le module fournisseur.
Autres codes status
 Une erreur est survenue.

Remarques

Un module fournisseur appelle la fonction NmrRegisterProvider pour s’inscrire en tant que fournisseur d’un NPI afin qu’elle puisse s’attacher aux modules clients qui s’inscrivent en tant que clients du même NPI.

Un module fournisseur appelle généralement la fonction NmrRegisterProvider à partir de sa fonction DriverEntry après avoir effectué toutes les autres tâches d’initialisation. L’appel à la fonction NmrRegisterProvider indique à la RMN que le module fournisseur est prêt à attacher à tous les modules clients qui se sont inscrits ou qui s’inscrivent en tant que clients du même NPI pour lequel le module fournisseur s’est inscrit en tant que fournisseur.

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

Voir aussi

DriverEntry

NPI_PROVIDER_CHARACTERISTICS

NmrDeregisterProvider