NPI_REGISTRATION_INSTANCE structure (netioddk.h)

La structure NPI_REGISTRATION_INSTANCE définit les données liées à l’inscription d’un module réseau auprès de la RMN.

Syntaxe

typedef struct _NPI_REGISTRATION_INSTANCE {
  USHORT        Version;
  USHORT        Size;
  PNPIID        NpiId;
  PNPI_MODULEID ModuleId;
  ULONG         Number;
  const VOID    *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;

Membres

Version

Version de la RMN auprès de laquelle le module réseau s’inscrit. Un module réseau doit définir ce membre sur zéro.

Size

Taille, en octets, de la structure NPI_REGISTRATION_INSTANCE.

NpiId

Pointeur vers l’identificateur NPI de l’indicateur NPI spécifique auquel le module réseau s’inscrit en tant que client ou fournisseur. Le type de données NPIID est défini comme suit :

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

Pointeur vers une structure NPI_MODULEID qui identifie de manière unique le module réseau.

Number

Numéro d’implémentation de l’indicateur de réseau pour lequel le module réseau s’inscrit en tant que client ou fournisseur. Un module réseau peut prendre en charge plusieurs implémentations du même NPI en s’inscrivant en tant que client ou fournisseur de chaque implémentation du NPI. S’il n’existe qu’une seule implémentation d’un NPI, ce membre est défini sur zéro.

NpiSpecificCharacteristics

Pointeur vers une structure qui spécifie des caractéristiques propres au module réseau. Le contenu de la structure est spécifique à NPI. Un module réseau doit définir ce membre sur NULL s’il s’inscrit en tant que client d’un NPI qui ne définit pas de structure de caractéristiques client ou s’il s’inscrit en tant que fournisseur d’un NPI qui ne définit pas de structure de caractéristiques de fournisseur.

Remarques

Une structure NPI_REGISTRATION_INSTANCE est membre du NPI_CLIENT_CHARACTERISTICS et NPI_PROVIDER_CHARACTERISTICS structures. Ces structures sont utilisées pour inscrire des modules réseau auprès de la RMN.

Lorsque la NMR appelle la fonction de rappel ClientAttachProvider d’un module client, elle passe un pointeur vers la structure NPI_REGISTRATION_INSTANCE du module fournisseur à laquelle le module client peut s’attacher. De même, lorsque la NMR appelle la fonction de rappel ProviderAttachClient d’un module fournisseur, elle transmet un pointeur vers la structure NPI_REGISTRATION_INSTANCE du module client auquel le module fournisseur peut s’attacher.

Un module réseau doit s’assurer que la mémoire pour le NPIID pointé par le membre NpiId , la mémoire de la structure NPI_MODULEID pointée par le membre ModuleId et la mémoire pour la structure des caractéristiques spécifiques de NPI pointée par le membre NpiSpecificCharacteristics restent valides et résident dans la mémoire tant que le module réseau est inscrit auprès du NMR.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	netioddk.h (inclure Wsk.h)

Voir aussi

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient