netioddk.h) (NPI_CLIENT_CHARACTERISTICS 结构

NPI_CLIENT_CHARACTERISTICS 结构定义客户端模块的特征。

语法

typedef struct _NPI_CLIENT_CHARACTERISTICS {
  USHORT                                 Version;
  USHORT                                 Length;
  PNPI_CLIENT_ATTACH_PROVIDER_FN         ClientAttachProvider;
  PNPI_CLIENT_DETACH_PROVIDER_FN         ClientDetachProvider;
  PNPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN ClientCleanupBindingContext;
  NPI_REGISTRATION_INSTANCE              ClientRegistrationInstance;
} NPI_CLIENT_CHARACTERISTICS;

成员

Version

客户端注册的 NMR 版本。 客户端模块应将此成员设置为零。

Length

NPI_CLIENT_CHARACTERISTICS 结构的大小(以字节为单位)。

ClientAttachProvider

指向客户端模块的 ClientAttachProvider 回调函数的指针。

ClientDetachProvider

指向客户端模块的 ClientDetachProvider 回调函数的指针。

ClientCleanupBindingContext

指向客户端模块的 的指针 ClientCleanupBindingContext 回调函数。 如果客户端模块没有为其绑定上下文动态分配内存,并且不需要对其绑定上下文进行其他清理,则客户端模块不需要实现 ClientCleanupBindingContext 回调函数。 如果客户端模块未实现 ClientCleanupBindingContext 回调函数,则此成员必须设置为 NULL

ClientRegistrationInstance

一个 NPI_REGISTRATION_INSTANCE 结构,用于指定客户端模块及其注册的 NPI 的标识。

注解

客户端模块在向 NMR 注册自身时,将指向 NPI_CLIENT_CHARACTERISTICS 结构的指针传递给 NmrRegisterClient 函数。

只要客户端模块已注册到 NMR,客户端模块就必须确保此结构保持有效且驻留在内存中。

要求

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

另请参阅

ClientAttachProvider

ClientCleanupBindingContext

ClientDetachProvider

NPI_REGISTRATION_INSTANCE

NmrRegisterClient