estructura WSK_PROVIDER_DISPATCH (wsk.h)
La estructura WSK_PROVIDER_DISPATCH especifica la tabla de distribución del subsistema WSK de funciones que no son específicas de un socket determinado.
Sintaxis
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;
Miembros
Version
Versión de la interfaz de programación de red (NPI) de WSK que usará el subsistema WSK para sus datos adjuntos a la aplicación WSK.
Reserved
Reservado para uso del sistema.
WskSocket
Puntero a la función WskSocket del subsistema WSK .
WskSocketConnect
Puntero a la función WskSocketConnect del subsistema WSK.
WskControlClient
Puntero a la función WskControlClient del subsistema WSK .
WskGetAddressInfo
Puntero a la función WskGetAddressInfo del subsistema WSK.
Este miembro está disponible a partir de Windows 7.
WskFreeAddressInfo
Puntero a la función WskFreeAddressInfo del subsistema WSK.
Este miembro está disponible a partir de Windows 7.
WskGetNameInfo
Puntero a la función WskGetNameInfo del subsistema WSK .
Este miembro está disponible a partir de Windows 7.
Comentarios
Cuando una aplicación WSK llama a la función WskCaptureProviderNPI , el subsistema WSK devuelve un puntero a una estructura WSK_PROVIDER_DISPATCH mediante el miembro Dispatch de la estructura WSK_CLIENT_NPI a la que apunta el parámetro WskProviderNpi .
Los números de versión principal y secundaria incluidos en el miembro Version se codifican mediante la macro MAKE_WSK_VERSION:
Version = MAKE_WSK_VERSION(Major,Minor);
Los números de versión principal y secundaria se pueden extraer del miembro Version mediante las macros WSK_MAJOR_VERSION y WSK_MINOR_VERSION:
Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);
El número de versión secundaria que se encuentra dentro del miembro Version de esta estructura podría ser un número de versión secundaria superior al solicitado por la aplicación WSK en el miembro Version de la estructura WSK_CLIENT_DISPATCH . Esta situación no debe causar un problema para la aplicación WSK porque las versiones secundarias superiores del NPI de WSK son un superconjunto estricto de versiones secundarias inferiores del NPI de WSK si tienen el mismo número de versión principal. El subsistema WSK especificará los miembros restantes de la estructura de WSK_PROVIDER_DISPATCH que se ajusten a la versión del NPI de WSK que se indica en el miembro Version de la estructura.
Para obtener más información sobre cómo adjuntar una aplicación WSK al subsistema WSK, vea Registro de una aplicación kernel de Winsock.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado | wsk.h (incluya Wsk.h) |