structure WSK_PROVIDER_CHARACTERISTICS (wsk.h)

La structure WSK_PROVIDER_CHARACTERISTICS spécifie les caractéristiques du sous-système WSK.

Syntaxe

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

Membres

HighestVersion

Version la plus élevée de l’interface de programmation réseau WSK (NPI) prise en charge par le sous-système WSK.

LowestVersion

Version la plus basse du NPI WSK prise en charge par le sous-système WSK.

Remarques

Lorsqu’un appel WskCaptureProviderNPI échoue avec status code STATUS_NOINTERFACE, l’application WSK peut utiliser un appel à WskQueryProviderCharacteristics pour interroger la plage des versions NPI WSK prises en charge par le sous-système WSK. WskQueryProviderCharacteristics retourne les informations de version au moyen de la structure WSK_PROVIDER_CHARACTERISTICS. Une application WSK peut utiliser ces informations pour déterminer si le sous-système WSK prend en charge une version du NPI WSK compatible avec l’application.

Les numéros de version principale et mineure contenus dans les membres HighestVersion et LowestVersion sont encodés à l’aide de la macro MAKE_WSK_VERSION :

Version = MAKE_WSK_VERSION(Major,Minor);

Les numéros de version principale et secondaire peuvent être extraits des membres HighestVersion et LowestVersion à l’aide des macros WSK_MAJOR_VERSION et WSK_MINOR_VERSION :

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

Si une application WSK détermine que le sous-système WSK prend en charge une version du NPI WSK compatible avec l’application, l’application doit appeler WskRegister et, au moyen du membre Dispatch de la structure WSK_CLIENT_NPI pointée vers le paramètre WskClientNpi , elle doit spécifier la version exacte de l’indicateur de réseau WSK qu’elle souhaite utiliser dans le membre Version de la structure WSK_CLIENT_DISPATCH . L’application WSK doit spécifier les membres restants de la structure WSK_CLIENT_DISPATCH pour qu’ils soient conformes à la version du NPI WSK spécifiée dans le membre Version de la structure.

Pour plus d’informations sur l’attachement d’une application WSK au sous-système WSK, consultez Inscription d’une application de noyau Winsock.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	wsk.h (inclure Wsk.h)

Voir aussi

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskQueryProviderCharacteristics

WskRegister