Win32 API 日本語リファレンス
ホーム › System.Diagnostics.Etw › PETW_BUFFER_CALLBACK

PETW_BUFFER_CALLBACK

コールバック

シグネチャ

BOOL PETW_BUFFER_CALLBACK(
    ETW_BUFFER_HEADER* Buffer,
    DWORD BufferSize,
    ETW_BUFFER_CALLBACK_INFORMATION* ConsumerInfo,
    void* CallbackContext
);

パラメーター

フィールド型説明
BufferETW_BUFFER_HEADER*

生のバッファーデータへのポインター。先頭は ETW_BUFFER_HEADER 構造体で始まり、その後にイベントデータが続きます。

既定では、このバッファーはコールバックが戻るまでの間のみ使用できます。コールバックが戻った後もバッファーを使用するには、ProcessTraceBufferIncrementReference を呼び出してください。これにより、そのバッファーに対して ProcessTraceBufferDecrementReference を呼び出すまで、バッファーが使用可能な状態に保たれます。

ProcessTrace は、こうしたバッファー参照がすべてデクリメントされるまで戻りません。

BufferSizeDWORD指定された Buffer のサイズ。
ConsumerInfoETW_BUFFER_CALLBACK_INFORMATION*処理セッションの現在の状態に関する情報を格納します。
CallbackContextvoid*ETW_OPEN_TRACE_OPTIONS.BufferCallbackContext で指定された、ユーザー提供のコンテキスト。

公式ドキュメント

ProcessTrace によって呼び出される BufferCallback の関数定義です。

戻り値

TRUE の場合、処理は継続されます。FALSE の場合、トレース処理は停止し、ProcessTrace は制御を返します。

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