XAsyncCompletionRoutine
非同期呼び出しの完了コールバックを表します。
構文
void XAsyncCompletionRoutine(
XAsyncBlock* asyncBlock
)
パラメーター
asyncBlock _Inout_
型: XAsyncBlock*
完了コールバックの XAsyncBlock へのポインター。
戻り値
型: void
解説
必要に応じて、XAsyncCompletionRoutineポインターを指定して、非同期呼び出しの完了コールバックを行うことができます。 完了コールバックは、非同期呼び出しの完了後に実行されるコールバック関数です。 非同期呼び出しの XAsyncBlock 構造の callback メンバーにXAsyncCompletionRoutine ポインターを指定できます。
通常、完了コールバックは、別のスレッドでの非同期呼び出しの結果を処理します。 完了コールバックは、非同期呼び出しが完了したときに呼び出されるコールバック関数を表します。 Callback 関数は XAsyncBlock ポインターを受け取り、次にこのポインターを使用して、コールバック関数の結果を取得します。
完了コールバックを指定する場合、XAsyncGetStatus 関数を使用して完了コールバックが完了しているかどうかを定期的に確認できます。非同期呼び出しが完了していれば、必要に応じて XAsyncGetResult および XAsyncGetResultSize を使用して、完了したタスクから結果を取得できます。
XAsyncCancel が呼び出されて非同期呼び出しがキャンセルされた場合でも、完了コールバックは呼び出されます。
XAsyncGetStatus または完了コールバックの Get\*Result メソッドを使用して、非同期呼び出しの結果を取得します。 非同期呼び出しがキャンセルされた場合、これらのメソッドは E_ABORTを返します。
Get\*Result メソッドを含む、非同期プロバイダーの実装パターンの詳細については、「非同期プログラミング モデル」を参照してください。
要件
ヘッダー: XAsync.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体