WSK_PROVIDER_CHARACTERISTICS 结构 (wsk.h)

项目
03/05/2024

WSK_PROVIDER_CHARACTERISTICS结构指定 WSK 子系统的特征。

语法

typedef struct _WSK_PROVIDER_CHARACTERISTICS {
  USHORT HighestVersion;
  USHORT LowestVersion;
} WSK_PROVIDER_CHARACTERISTICS, *PWSK_PROVIDER_CHARACTERISTICS;

成员

HighestVersion

WSK 子系统支持的最高版本的 WSK 网络编程接口 (NPI) 。

LowestVersion

WSK 子系统支持的 WSK NPI 的最低版本。

注解

当 WskCaptureProviderNPI 调用失败并STATUS_NOINTERFACE状态代码时，WSK 应用程序可以使用对的调用 WskQueryProviderCharacteristics 用于查询 WSK 子系统支持的 WSK NPI 版本范围。 WskQueryProviderCharacteristics 通过 WSK_PROVIDER_CHARACTERISTICS 结构返回版本信息。 WSK 应用程序可以使用此信息来确定 WSK 子系统是否支持与应用程序兼容的 WSK NPI 版本。

HighestVersion 和 LowestVersion 成员中包含的主版本号和次要版本号使用 MAKE_WSK_VERSION 宏进行编码：

Version = MAKE_WSK_VERSION(Major,Minor);

可以使用 WSK_MAJOR_VERSION 和 WSK_MINOR_VERSION 宏从 HighestVersion 和 LowestVersion 成员中提取主版本号和次要版本号：

Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);

如果 WSK 应用程序确定 WSK 子系统支持与应用程序兼容的 WSK NPI 版本，则应用程序应调用 WskRegister，并且通过 WskClientNpi 参数指向的 WSK_CLIENT_NPI 结构的 Dispatch 成员，它应指定要在 WSK_CLIENT_DISPATCH 结构的 Version 成员中使用的 WSK NPI 的确切版本。 WSK 应用程序应指定WSK_CLIENT_DISPATCH结构的其余成员，以符合结构的版本成员中指定的 WSK NPI 的版本。

有关将 WSK 应用程序附加到 WSK 子系统的详细信息，请参阅注册 Winsock 内核应用程序。