> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameUiShowPlayerPickerAsync

> XGameUiShowPlayerPickerAsync

# XGameUiShowPlayerPickerAsync

顯示選擇器 UI，讓正在玩遊戲的人從所呈現的人員清單中選取玩家。

## 語法

```cpp theme={null}
HRESULT XGameUiShowPlayerPickerAsync(  
         XAsyncBlock* async,  
         XUserHandle requestingUser,  
         const char* promptText,  
         uint32_t selectFromPlayersCount,  
         const uint64_t* selectFromPlayers,  
         uint32_t preSelectedPlayersCount,  
         const uint64_t* preSelectedPlayers,  
         uint32_t minSelectionCount,  
         uint32_t maxSelectionCount  
)  
```

### 參數

*async*   \_In\_<br />類型：[XAsyncBlock\*](/zh-TW/reference/system/xasync/structs/xasyncblock)

指向傳遞給 [XAsyncRun](/zh-TW/reference/system/xasync/functions/xasyncrun) 之 [XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock) 的指標。

*requestingUser*   \_In\_<br />類型：XUserHandle

要求玩家選擇器 UI 之使用者的控制代碼。

*promptText*   \_In\_z\_<br />類型：char\*

提示顯示文字。

*selectFromPlayersCount*   \_In\_<br />類型：uint32\_t

呼叫者可從中選取的玩家數目。

*selectFromPlayers*   \_In\_reads\_(selectFromPlayersCount)<br />類型：uint64\_t\*

指向呼叫者可從中選取之玩家識別碼清單的指標。

*preSelectedPlayersCount*   \_In\_<br />類型：uint32\_t

呈現 UI 時預先選取的玩家數目。

*preSelectedPlayers*   \_In\_reads\_opt\_(preSelectedPlayersCount)<br />類型：uint64\_t\*

指向呈現 UI 時預先選取之玩家識別碼清單的指標。

*minSelectionCount*   \_In\_<br />類型：uint32\_t

呼叫者必須選取的最少人數。

*maxSelectionCount*   \_In\_<br />類型：uint32\_t

呼叫者可選取的最多人數。

### 傳回值

類型：HRESULT

非同步呼叫的 HRESULT 成功或錯誤碼。

若要取得結果，請在 *AsyncBlock* 回呼內或 *AsyncBlock* 完成之後，呼叫 [XGameUiShowPlayerPickerResultCount](/zh-TW/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount) 和 [XGameUiShowPlayerPickerResult](/zh-TW/reference/system/xgameui/functions/xgameuishowplayerpickerresult)。

## 備註

玩家識別碼必須是 XBOX 使用者識別碼 (XUID)，其為 *uint64\_t* 值。

呼叫 UI 會讓您的遊戲進入 *受限模式*。在受限模式下，當您的遊戲位於所呼叫 UI 的背景時，會獲得較少的系統資源。若要深入了解受限模式及遊戲的其他作業模式，請參閱 [XBOX 遊戲生命週期 (NDA 主題)](/zh-TW/build/console-features/console-workflows/xbox-game-life-cycle)。

## 需求

**標頭：** XGameUI.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XGameUI](/zh-TW/reference/system/xgameui/xgameui_members)<br />[XGameUiShowPlayerPickerResult](/zh-TW/reference/system/xgameui/functions/xgameuishowplayerpickerresult)<br />[XGameUiShowPlayerPickerResultCount](/zh-TW/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount)<br />[XBOX 遊戲生命週期 (NDA 主題)](/zh-TW/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync.md)
- [XGameUiShowPlayerPickerResult](/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md)