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 を含む) |