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) |