WSK_PROVIDER_CHARACTERISTICS結構 (wsk.h)

發行項
03/01/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結構的其餘成員，以符合結構之 Version 成員中指定的 WSK NPI 版本。

如需將 WSK 應用程式附加至 WSK 子系統的詳細資訊，請參閱註冊 Winsock 核心應用程式。