WSK_PROVIDER_DISPATCH struttura (wsk.h)

Articolo
03/05/2024

La struttura WSK_PROVIDER_DISPATCH specifica la tabella di invio del sottosistema WSK delle funzioni non specifiche di un socket specifico.

Sintassi

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;

Members

Version

Versione dell'interfaccia di programmazione di rete WSK usata dal sottosistema WSK per l'allegato all'applicazione WSK.

Reserved

Riservato per l'utilizzo nel sistema.

WskSocket

Puntatore alla funzione WskSocket del sottosistema WskSocket .

WskSocketConnect

Puntatore alla funzione WskSocketConnect del sottosistema WskSocketConnect .

WskControlClient

Puntatore alla funzione WskControlClient del sottosistema WskControlClient .

WskGetAddressInfo

Puntatore alla funzione WskGetAddressInfo del sottosistema WskGetAddressInfo .

Questo membro è disponibile a partire da Windows 7.

WskFreeAddressInfo

Puntatore alla funzione WskFreeAddressInfo del sottosistema WskFreeAddressInfo .

Questo membro è disponibile a partire da Windows 7.

WskGetNameInfo

Puntatore alla funzione WskGetNameInfo del sottosistema WskGetNameInfo .

Questo membro è disponibile a partire da Windows 7.

Commenti

Quando un'applicazione WSK chiama la funzione WskCaptureProviderNPI , il sottosistema WSK restituisce un puntatore a una struttura WSK_PROVIDER_DISPATCH tramite il membro Dispatch della struttura WSK_CLIENT_NPI a cui punta il parametro WskProviderNpi .

I numeri di versione principali e secondari contenuti all'interno del membro Version vengono codificati usando la macro MAKE_WSK_VERSION:

Version = MAKE_WSK_VERSION(Major,Minor);

I numeri di versione principali e secondari possono essere estratti dal membro Version usando le macro WSK_MAJOR_VERSION e WSK_MINOR_VERSION:

Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);

Il numero di versione secondaria contenuto all'interno del membro Version di questa struttura potrebbe essere un numero di versione minore superiore a quello richiesto dall'applicazione WSK nel membro Version della struttura WSK_CLIENT_DISPATCH . Questa situazione non deve causare un problema per l'applicazione WSK perché le versioni secondarie più elevate dell'NPI WSK sono un superset rigoroso di versioni secondarie inferiori dell'NPI WSK se hanno lo stesso numero di versione principale. Il sottosistema WSK specifica i membri rimanenti della struttura WSK_PROVIDER_DISPATCH conforme alla versione dell'npI WSK indicato nel membro Version della struttura.

Per altre informazioni sul collegamento di un'applicazione WSK al sottosistema WSK, vedere Registrazione di un'applicazione kernel Winsock.