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