netioddk.h) (NPI_REGISTRATION_INSTANCE 结构
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 中注册。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 | netioddk.h (包括 Wsk.h) |