XGameUiShowPlayerPickerAsync
ゲームをプレイしている人物が、提示された人物のリストからプレイヤーを選択できるピッカー UI を表示します。構文
パラメーター
async _In_Type: XAsyncBlock* XAsyncRun に渡される XAsyncBlock へのポインター。 requestingUser _In_
Type: XUserHandle プレイヤー ピッカー UI を要求しているユーザーへのハンドル。 promptText _In_z_
Type: char* プロンプトの表示テキスト。 selectFromPlayersCount _In_
Type: uint32_t 呼び出し元が選択できるプレイヤーの数。 selectFromPlayers _In_reads_(selectFromPlayersCount)
Type: uint64_t* 呼び出し元が選択できるプレイヤー ID のリストへのポインター。 preSelectedPlayersCount _In_
Type: uint32_t UI が表示されたときにあらかじめ選択されているプレイヤーの数。 preSelectedPlayers _In_reads_opt_(preSelectedPlayersCount)
Type: uint64_t* UI が表示されたときにあらかじめ選択されているプレイヤー ID のリストへのポインター。 minSelectionCount _In_
Type: uint32_t 呼び出し元が選択する必要のある最小人数。 maxSelectionCount _In_
Type: uint32_t 呼び出し元が選択できる最大人数。
戻り値
Type: HRESULT 非同期呼び出しの HRESULT 成功またはエラー コード。 結果を取得するには、AsyncBlock コールバック内または AsyncBlock の完了後に XGameUiShowPlayerPickerResultCount および XGameUiShowPlayerPickerResult を呼び出します。解説
プレイヤー ID は XBOX ユーザー ID (XUID) である必要があり、これは uint64_t 値です。 UI を呼び出すと、ゲームは 制約付きモード に入ります。制約付きモードでは、呼び出された UI のバックグラウンドにある間、タイトルが受け取るシステム リソースが少なくなります。制約付きモードやタイトルのその他の運用モードの詳細については、「XBOX ゲーム ライフ サイクル (NDA トピック)」を参照してください。要件
ヘッダー: XGameUI.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、Steam Deck、XBOX One ファミリー本体および XBOX Series 本体関連項目
XGameUIXGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
XBOX ゲーム ライフ サイクル (NDA トピック)