ホーム › NetworkManagement.QoS › TCI_NOTIFY_HANDLER

TCI_NOTIFY_HANDLER

コールバック

シグネチャ

void TCI_NOTIFY_HANDLER(
    HANDLE ClRegCtx,
    HANDLE ClIfcCtx,
    DWORD Event,
    HANDLE SubCode,
    DWORD BufSize,
    void* Buffer
);

パラメーター

フィールド	型	説明
ClRegCtx	HANDLE	クライアントの登録コンテキスト。クライアントが TcRegisterClient 関数を呼び出す際に、クライアントからトラフィック制御に渡されたものです。
ClIfcCtx	HANDLE	クライアントのインターフェイスコンテキスト。クライアントが TcOpenInterface 関数を呼び出す際に、クライアントからトラフィック制御に渡されたものです。TC_NOTIFY_IFC_UP イベントの間は ClIfcCtx は利用できず、NULL に設定される点に注意してください。
Event	DWORD	通知イベントを表します。通知イベントの一覧については、「解説」セクションを参照してください。
SubCode	HANDLE	通知イベントをさらに詳細に特定するために使用されるハンドル。64 ビット Windows のプログラミングに関する注意事項については、以下の「注意」を参照してください。
BufSize	DWORD	通知イベントに付随するバッファーのサイズ (バイト単位)。
Buffer	void*	Event および SubCode に対応する詳細なイベント情報を格納したバッファー。

公式ドキュメント

ClNotifyHandler 関数は、フローの削除、フィルターパラメーターの変更、インターフェイスのクローズなど、トラフィック制御固有のさまざまなイベントをクライアントに通知するためにトラフィック制御が使用します。

ClNotifyHandler コールバック関数は、トラフィック制御サービスを使用するすべてのクライアントが公開する必要があります。

解説(Remarks)

通知イベントによっては、トラフィック制御クライアントが特定の処理を行ったり、適切に応答したりする必要があります。たとえば、対象のインターフェイスについてフィルターを削除する、フローを列挙するなどの処理です。

次の表は、各種の通知イベントを示しています。

Event	SubCode	バッファーの内容	説明
TC_NOTIFY_IFC_UP	なし	新しいインターフェイスのインターフェイス名	新しいトラフィック制御インターフェイスが起動中であり、アドレスの一覧が示されます。
TC_NOTIFY_IFC_CLOSE	クローズの理由	クローズされたインターフェイスのインターフェイス名	クライアントが開いたインターフェイスが、システムによってクローズされることを示します。通知ハンドラーから戻った時点で、そのインターフェイスと、それがサポートするフローおよびフィルターはシステムによってクローズされる点に注意してください。クライアントがインターフェイスをクローズしたり、フローやフィルターを削除したりする必要はありません。
TC_NOTIFY_IFC_CHANGE	なし	新しいパラメーター値	TcQueryInterface 関数の NotifyChange パラメーターによってインターフェイスの変更通知を登録したクライアントに通知するために使用されます。
TC_NOTIFY_PARAM_CHANGED	TcQueryInterface 関数を使用してクエリしたトラフィック制御パラメーターの GUID へのポインター。	新しいパラメーター値	このイベントは、NotifyChange フラグを設定して事前にクエリしたパラメーターが変更された結果として通知されます。
TC_NOTIFY_FLOW_CLOSE	ClFlowCtx		クライアントが作成したフローがシステムによってクローズされたことを示します。関連するフィルターはすべてシステムが削除します。

注意 ClNotifyHandler 関数を使用するには管理者権限が必要です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)