NPI_REGISTRATION_INSTANCE结构(netioddk.h)

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-specific。 如果网络模块注册为未定义客户端特征结构的 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,该成员就一直有效且驻留在内存中。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
标头 netioddk.h (包括 Wsk.h)

另请参阅

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient