estructura WSK_PROVIDER_DISPATCH (wsk.h)

  • Artículo

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)

Consulte también

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskControlClient

WskSocket

WskSocketConnect