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) |