netioddk.h) (NPI_REGISTRATION_INSTANCE 结构

项目
04/30/2024

NPI_REGISTRATION_INSTANCE结构定义与向 NMR 注册网络模块相关的数据。

语法

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

成员

Version

网络模块注册到的 NMR 版本。网络模块应将此成员设置为零。

Size

NPI_REGISTRATION_INSTANCE 结构的大小（以字节为单位）。

NpiId

指向网络模块注册为客户端或提供程序的特定 NPI 的 NPI 标识符的指针。 NPIID 数据类型定义为：

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

指向唯一标识网络模块的NPI_MODULEID 结构的指针。

Number

网络模块为其注册为客户端或提供程序的 NPI 的实现号。网络模块可以通过注册为 NPI 的每个实现的客户端或提供程序来支持同一 NPI 的多个实现。如果 NPI 只有一个实现，则此成员设置为零。

NpiSpecificCharacteristics

指向结构的指针，该结构指定网络模块所特有的特征。结构的内容特定于 NPI。如果网络模块注册为未定义客户端特征结构的 NPI 的客户端，或者它注册为未定义提供程序特征结构的 NPI 的提供程序，则应将此成员设置为 NULL 。

注解

NPI_REGISTRATION_INSTANCE 结构是 NPI_CLIENT_CHARACTERISTICS 和的成员 NPI_PROVIDER_CHARACTERISTICS 结构。这些结构用于向 NMR 注册网络模块。

当 NMR 调用客户端模块的 ClientAttachProvider 回调函数时，它会传递指向客户端模块可以附加到的提供程序模块的NPI_REGISTRATION_INSTANCE结构的指针。同样，当 NMR 调用提供程序模块的 ProviderAttachClient 回调函数时，它会传递指向提供程序模块可以附加到的客户端模块的NPI_REGISTRATION_INSTANCE结构的指针。

网络模块必须确保 NpiId 成员指向的 NPIID 内存、ModuleId 成员指向的 NPI_MODULEID 结构的内存，以及 NpiSpecificCharacteristics 成员所指向的 NPI 特定特征结构的内存在内存中保持有效且驻留在内存中，前提是网络模块已在 NMR 中注册。