WSK_PROVIDER_DISPATCH 構造体 (wsk.h)

WSK_PROVIDER_DISPATCH構造体は、WSK サブシステムの特定のソケットに固有ではない関数のディスパッチ テーブルを指定します。

構文

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;

メンバー

Version

WSK サブシステムが WSK アプリケーションへの添付ファイルに使用する WSK ネットワーク プログラミング インターフェイス (NPI) のバージョン。

Reserved

システムで使用するために予約されています。

WskSocket

WSK サブシステムの WskSocket 関数へのポインター。

WskSocketConnect

WSK サブシステムの WskSocketConnect 関数へのポインター。

WskControlClient

WSK サブシステムの WskControlClient 関数へのポインター。

WskGetAddressInfo

WSK サブシステムの WskGetAddressInfo 関数へのポインター。

このメンバーは、Windows 7 以降で使用できます。

WskFreeAddressInfo

WSK サブシステムの WskFreeAddressInfo 関数へのポインター。

このメンバーは、Windows 7 以降で使用できます。

WskGetNameInfo

WSK サブシステムの WskGetNameInfo 関数へのポインター。

このメンバーは、Windows 7 以降で使用できます。

注釈

WSK アプリケーションが WskCaptureProviderNPI 関数を呼び出すと、WSK サブシステムは、WskProviderNpi パラメーターが指すWSK_CLIENT_NPI構造体の Dispatch メンバーを使用して、WSK_PROVIDER_DISPATCH構造体へのポインターを返します。

Version メンバーに含まれるメジャー バージョン番号とマイナー バージョン番号は、MAKE_WSK_VERSION マクロを使用してエンコードされます。

Version = MAKE_WSK_VERSION(Major,Minor);

メジャー バージョン番号とマイナー バージョン番号は、WSK_MAJOR_VERSIONマクロと WSK_MINOR_VERSION マクロを使用して Version メンバーから抽出できます。

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

この構造体の Version メンバー内に含まれるマイナー バージョン番号は、WSK_CLIENT_DISPATCH構造体の Version メンバーで WSK アプリケーションによって要求されたものより大きいマイナー バージョン番号である可能性があります。 WSK NPI のマイナー バージョンが高いほど、メジャー バージョン番号が同じである場合、WSK NPI の下位マイナー バージョンの厳密なスーパーセットであるため、この状況で WSK アプリケーションに問題が発生することはありません。 WSK サブシステムは、構造体の Version メンバーに示されている WSK NPI のバージョンに準拠するように、WSK_PROVIDER_DISPATCH構造体の残りのメンバーを指定します。

WSK アプリケーションを WSK サブシステムにアタッチする方法の詳細については、「 Winsock カーネル アプリケーションの登録」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
Header	wsk.h (Wsk.h を含む)

こちらもご覧ください

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskControlClient

WskSocket

WskSocketConnect