WSK_SET_STATIC_EVENT_CALLBACKS

WSK アプリケーションは、WSK_SET_STATIC_EVENT_CALLBACKS クライアント制御操作を使用して、作成するすべてのソケットで特定のイベント コールバック関数を自動的に有効にします。 この方法で有効にされているイベント コールバック関数は常に有効であり、後で WSK アプリケーションによって無効にしたり再度有効にしたりすることはできません。 ただし、WSK アプリケーションが、作成するすべてのソケットで特定のイベント コールバック関数を常に有効にする場合、アプリケーションはこの方法を使用してこれらのイベント コールバック関数を自動的に有効にする必要があります。そうすることで、パフォーマンスが大幅に向上するためです。

WSK アプリケーションが WSK_SET_STATIC_EVENT_CALLBACKS クライアント制御操作を使用する場合は、ソケットを作成する前にその操作を実行する必要があります。

作成するすべてのソケットで特定のイベント コールバック関数を自動的に有効にするために、WSK アプリケーションは次のパラメーターを指定して WskControlClient 関数を呼び出します。

パラメーター

ControlCode

WSK_SET_STATIC_EVENT_CALLBACKS

InputSize

sizeof(WSK_EVENT_CALLBACK_CONTROL)

InputBuffer

自動的に有効にするイベント コールバック関数を指定する WSK_EVENT_CALLBACK_CONTROL 構造体へのポインター

OutputSize

0

OutputBuffer

NULL

OutputSizeReturned

NULL

Irp

NULL

WSK アプリケーションでは、WSK_EVENT_CALLBACK_CONTROL 構造体の EventMask メンバーで、異なるソケットの種類に対してイベント フラグの組み合わせを指定できます。 WSK アプリケーションが新しいソケットを作成すると、WSK サブシステムは、作成されている WSK ソケットの特定のカテゴリに対して適切なイベント コールバック関数を自動的に有効にします。

標準的な WSK イベント コールバック関数のイベント フラグの詳細については、SO_WSK_EVENT_CALLBACK を参照してください。

ソケットのイベント コールバック関数の有効化と無効化の詳細については、「イベント コールバック関数の有効化と無効化」を参照してください。

Irp パラメーターは、このクライアント制御操作では NULL である必要があります。

要件

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダー

Wsk.h (Wsk.h のインクルード)