次の方法で共有

PartyManager::SetProfilingCallbacksForMethodEntryExit

  • [アーティクル]

必要に応じて、インストルメント化されたメソッドの開始時または終了時jに Party ライブラリが行うプロファイリング イベント コールバックを構成します。

構文

PartyError SetProfilingCallbacksForMethodEntryExit(  
    PartyProfilingMethodEntranceCallback profilingMethodEntranceCallback,  
    PartyProfilingMethodExitCallback profilingMethodExitCallback  
)

パラメーター

profilingMethodEntranceCallback PartyProfilingMethodEntranceCallback
オプション

パーティ ライブラリがプロファイリング用に装備された内部メソッドに入るときに行われるコールバック。

profilingMethodExitCallback PartyProfilingMethodExitCallback
オプション

Party ライブラリがプロファイリング用に組み込まれた内部メソッドを終了しようとしているときに行われるコールバック。

戻り値

PartyError

呼び出しが成功した場合は c_partyErrorSuccess、それ以外の場合はエラー コードになります。 人間が判読できる形式のエラー コードは、GetErrorMessage() を介して取得できます。

解説

この方法では、外部プロファイリング ツールでパーティ ライブラリのパフォーマンス メトリックを記録および視覚化するために、タイトルでカスタム プロファイリング コールバック関数をインストールできます。

このメソッドは、パーティー ライブラリが初期化されていない場合にのみ呼び出すことができます。 パーティの初期化中に呼び出しを行うと失敗し、エラーが返されます。

オプションのコールバックを nullptr に設定すると、パーティ ライブラリはそのイベント タイプに対してプロファイリング コールバックを行わなくなります。

タイトルのパフォーマンスに対するプロファイリングの影響を最小限に抑えるために、これらのイベントのコールバックは 1 秒あたり数百回または数千回起動されることが予想されるため、できる限り軽量に保つ必要があります。

このメソッドは、ライブラリの Windows および Microsoft Game Core バージョンでのみサポートされます。 他のプラットフォームでの呼び出しは失敗します。

要件

ヘッダー: Party.h

関連項目

PartyManager
PartyProfilingMethodEntranceCallback
PartyProfilingMethodExitCallback
PartyManager::GetProfilingCallbacksForMethodEntryExit