structure WSK_PROVIDER_DISPATCH (wsk.h)
La structure WSK_PROVIDER_DISPATCH spécifie la table de répartition du sous-système WSK des fonctions qui ne sont pas spécifiques à un socket particulier.
Syntaxe
typedef struct _WSK_PROVIDER_DISPATCH {
USHORT Version;
USHORT Reserved;
PFN_WSK_SOCKET WskSocket;
PFN_WSK_SOCKET_CONNECT WskSocketConnect;
PFN_WSK_CONTROL_CLIENT WskControlClient;
PFN_WSK_GET_ADDRESS_INFO WskGetAddressInfo;
PFN_WSK_FREE_ADDRESS_INFO WskFreeAddressInfo;
PFN_WSK_GET_NAME_INFO WskGetNameInfo;
} WSK_PROVIDER_DISPATCH, *PWSK_PROVIDER_DISPATCH;
Membres
Version
Version de l’interface de programmation réseau WSK (NPI) que le sous-système WSK utilisera pour sa pièce jointe à l’application WSK.
Reserved
Réservé pour le système.
WskSocket
Pointeur vers la fonction WskSocket du sous-système WSK.
WskSocketConnect
Pointeur vers la fonction WskSocketConnect du sous-système WSK.
WskControlClient
Pointeur vers la fonction WskControlClient du sous-système WSK.
WskGetAddressInfo
Pointeur vers la fonction WskGetAddressInfo du sous-système WSK.
Ce membre est disponible à partir de Windows 7.
WskFreeAddressInfo
Pointeur vers la fonction WskFreeAddressInfo du sous-système WSK.
Ce membre est disponible à partir de Windows 7.
WskGetNameInfo
Pointeur vers la fonction WskGetNameInfo du sous-système WSK.
Ce membre est disponible à partir de Windows 7.
Remarques
Lorsqu’une application WSK appelle la fonction WskCaptureProviderNPI , le sous-système WSK retourne un pointeur vers une structure WSK_PROVIDER_DISPATCH au moyen du membre Dispatch de la structure WSK_CLIENT_NPI pointée par le paramètre WskProviderNpi .
Les numéros de version principale et secondaire contenus dans le membre Version sont encodés à l’aide de la macro MAKE_WSK_VERSION :
Version = MAKE_WSK_VERSION(Major,Minor);
Les numéros de version principale et mineure peuvent être extraits du membre Version à l’aide des macros WSK_MAJOR_VERSION et WSK_MINOR_VERSION :
Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);
Le numéro de version secondaire contenu dans le membre Version de cette structure peut être un numéro de version secondaire supérieur à celui demandé par l’application WSK dans le membre Version de la structure WSK_CLIENT_DISPATCH . Cette situation ne doit pas causer de problème pour l’application WSK, car les versions mineures supérieures du NPI WSK sont un sur-ensemble strict de versions mineures inférieures du NPI WSK si elles ont le même numéro de version majeure. Le sous-système WSK spécifie les membres restants de la structure WSK_PROVIDER_DISPATCH pour qu’ils soient conformes à la version du NPI WSK indiqué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) |