Microsoft Game Development Kit API タスクの実行例 - XBOX Game Development Documentation

このトピックでは、Microsoft Game Development Kit (GDK) API タスクを実行する方法の例を示します。非同期の Microsoft Game Development Kit (GDK) API 関数は、ワークコールバックを内部的に実装しています。ただし、非同期ブロックで指定されているタスクキューによって制御される形で実行されます。これらのメソッドを実行するには、非同期ブロックと、API に必要なパラメーターが必要です。

// Set up the async block and completion callback.
XAsyncBlock* async = new XAsyncBlock{};
async->queue = taskQueue;
async->context = nullptr;
async->callback = [](XAsyncBlock* async)
{
    XUserHandle newUser = nullptr;
    HRESULT result = XUserAddResult(async, &newUser);
    // Handle the completion callback.
    delete async;
};

// Start the async call.
HRESULT hr = XUserAddAsync(XUserAddOptions::None, async);
if (FAILED(hr))
{
    delete async;
}

このコードは、汎用タスクの実行用のコードとあまり変わりません。ワークコールバックを指定して XAsyncRun を使用する代わりに、使用したい API を呼び出します。非同期ブロックの設定方法は同じです。ここでの違いは、XUserAddAsync には呼び出しから取得するデータがあり、そのデータは完了コールバックの中で XUserAddResult を使って取得される点です。

リファレンス API ドキュメント

XAsync (API 目次)
- 関数
  - XAsyncRun
xuser (API 目次)
- 関数
  - XUserAddAsync
  - XUserAddResult

関連項目

XAsync ライブラリの概要非同期タスクのセットアップ (例) 単純なタスクの実行 (例) XAsync

最終更新日 2026年8月13日

関連トピック

単純なタスクの実行例非同期タスクのセットアップ例 XAsync ライブラリの概要非同期タスクプログラミング向け XAsync ライブラリスケジュールタスクのクイックスタート

⌘I