WSK_PROVIDER_DISPATCH - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wsk.h
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;
View the official Windows Driver Kit DDI referenceNo description available.
The WSK_PROVIDER_DISPATCH structure specifies the WSK subsystem's dispatch table of functions that are not specific to a particular socket.
VersionThe version of the WSK Network Programming Interface (NPI) that the WSK subsystem will use for its attachment to the WSK application.
ReservedReserved for system use.
WskSocketA pointer to the WSK subsystem's WskSocket function.
WskSocketConnectA pointer to the WSK subsystem's WskSocketConnect function.
WskControlClientA pointer to the WSK subsystem's WskControlClient function.
WskGetAddressInfoA pointer to the WSK subsystem's WskGetAddressInfo function.
This member is available beginning with Windows 7.
WskFreeAddressInfoA pointer to the WSK subsystem's WskFreeAddressInfo function.
This member is available beginning with Windows 7.
WskGetNameInfoA pointer to the WSK subsystem's WskGetNameInfo function.
This member is available beginning with Windows 7.
When a WSK application calls the WskCaptureProviderNPI function, the WSK subsystem returns a pointer to a WSK_PROVIDER_DISPATCH structure by means of the Dispatch member of the WSK_CLIENT_NPI structure pointed to by the WskProviderNpi parameter.
The major and minor version numbers that are contained within the Version member are encoded by using the MAKE_WSK_VERSION macro:
Version = MAKE_WSK_VERSION(Major,Minor);
The major and minor version numbers can be extracted from the Version member by using the WSK_MAJOR_VERSION and WSK_MINOR_VERSION macros:
Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);
The minor version number that is contained within the Version member of this structure might be a higher minor version number than what was requested by the WSK application in the Version member of the WSK_CLIENT_DISPATCH structure. This situation should not cause a problem for the WSK application because higher minor versions of the WSK NPI are a strict superset of lower minor versions of the WSK NPI if they have the same major version number. The WSK subsystem will specify the remaining members of the WSK_PROVIDER_DISPATCH structure to conform to the version of the WSK NPI that is indicated in the Version member of the structure.
For more information about attaching a WSK application to the WSK subsystem, see Registering a Winsock Kernel Application.