HCTraceCallback
ゲームが独自のログに統合できるように、libHttpClient のトレース メッセージを受け取ります。構文
パラメーター
areaName _In_z_型: const char* メッセージを生成したトレース領域の null で終わる名前。libHttpClient は
HTTPCLIENT 領域と WEBSOCKET 領域を使用します。XBOX services API (XSAPI) など、libHttpClient の上に構築されたライブラリは、XSAPI などの独自の領域を報告します。
level _In_型: HCTraceLevel メッセージのトレース レベル。 threadId _In_
型: uint64_t メッセージを生成したスレッドの ID。Windows PC および XBOX 本体では、この値は
GetCurrentThreadId が返すオペレーティング システムのスレッド ID です。
timestamp _In_型: uint64_t メッセージの時刻。トレースを開始した直近の初期化、つまりトレースの参照カウントを 0 から 1 に変更した HCInitialize または HCTraceInit の呼び出しからの経過ミリ秒数です。 message _In_z_
型: const char* null で終わる、書式設定されたトレース メッセージ。このメッセージには、libHttpClient がデバッガー出力に追加するスレッド、レベル、時刻、および領域のプレフィックスは含まれません。
戻り値
型: void解説
HCTraceSetClientCallback を呼び出してコールバックを登録します。 libHttpClient は、トレース メッセージを生成したスレッドでコールバックを同期的に呼び出します。複数のスレッドが同時にコールバックを呼び出す可能性があるため、コールバックはスレッド セーフにし、すぐに戻るようにしてください。 areaName と message の文字列は、呼び出しの間のみ有効です。後で必要な場合はコピーしてください。 libHttpClient は、メッセージのトレース領域の詳細レベル以下のメッセージに対してのみコールバックを呼び出します。libHttpClient のトレース領域の詳細レベルを変更するには、HCSettingsSetTraceLevel を呼び出します。 HCTraceCleanup を直接呼び出すたびに、登録されているすべてのクライアント コールバックが削除されます。libHttpClient の最終的なクリーンアップがトレースのクリーンアップに達したときにも、ライブラリのクリーンアップによって削除されます。登録を削除しても、既に実行中のコールバックの完了は待機されません。libHttpClient を再初期化した後は、コールバックを再度登録してください。例
次の例では、HCInitialize が既に成功していることを前提としています。要件
ヘッダー: trace.h ライブラリ: libHttpClient.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体関連項目
traceHCTraceSetClientCallback
HCSettingsSetTraceLevel
HCTraceLevel
Troubleshooting XBOX services APIs
