Skip to main content

XGameUiShowMessageDialogAsync

顯示可自訂之訊息對話方塊的 UI。結果中會包含使用者所按按鈕的索引。

語法

參數

async _In_
類型:XAsyncBlock*
傳遞至 XAsyncRun 之 XAsyncBlock 的指標。 titleText _In_
類型:char*
訊息對話方塊的文字標題。 contentText _In_
類型:char*
訊息對話方塊內顯示的文字。 firstButtonText _In_opt_
類型:char*
訊息對話方塊第一個按鈕上顯示的文字。 secondButtonText _In_opt_
類型:char*
訊息對話方塊第二個按鈕上顯示的文字。 thirdButtonText _In_opt_
類型:char*
訊息對話方塊第三個按鈕上顯示的文字。 defaultButton _In_
類型:XGameUiMessageDialogButton
表示訊息對話方塊第一次顯示時預設選取的按鈕。 cancelButton _In_
類型:XGameUiMessageDialogButton
表示代表取消動作的按鈕。

傳回值

類型:HRESULT 非同步呼叫的 HRESULT 成功或錯誤碼。 若要取得結果,請在 XAsyncBlock 回呼內或 XAsyncBlock 完成後呼叫 XGameUiShowMessageDialogResult。

備註

與其他 XGameUI* 函式一樣,XGameUiShowMessageDialogAsync 會在遊戲分割區之外轉譯其 UI,並在每個畫面傳送至顯示裝置之前,將結果與遊戲的輸出進行合成。這表示無論遊戲是否正在轉譯,都可以使用 XGameUiShowMessageDialogAsync 向使用者呈現資訊。 呼叫 UI 會導致您的遊戲進入_受限模式_。在受限模式下,您的遊戲位於所呼叫 UI 的背景時,將會獲得較少的系統資源。若要深入了解受限模式及遊戲的其他作業模式,請參閱 XBOX 遊戲生命週期 (NDA 主題)。 下列範例程式碼說明如何在開發情境中使用此方法,建立等待輸入的封鎖 UI。這對於在當機失敗的位置暫停目前執行,並回報當機位置或提示開發人員附加偵錯工具特別有用。

需求

標頭: XGameUI.h 程式庫: xgameruntime.lib 支援的平台: Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XGameUI
XGameUIShowMessageDialogResult
XBOX 遊戲生命週期 (NDA 主題)
Last modified on October 6, 2026