XblMultiplayerActivitySetActivityAsync
設定或更新本機使用者的多人遊戲活動。語法
參數
xblContext _In_類型：XblContextHandle 本機使用者的 XBOX Live 內容。 activityInfo _In_
類型：XblMultiplayerActivityInfo* 活動的相關資訊。
maxPlayers 和 currentPlayers 欄位為選擇性；如果設為 0 則會忽略。platform 欄位的值會被忽略；XSAPI 會自動在適當的本機平台上設定活動。
allowCrossPlatformJoin _In_類型：bool 如果活動應可在遊戲支援的其他平台上加入，則為 True。 async _In_
類型：XAsyncBlock* 此作業的
XAsyncBlock。
傳回值
類型：HRESULT 此 API 作業的 HRESULT 傳回碼。備註
當遊戲開始或加入多人遊戲體驗時，應建立活動。這麼做可讓殼層和遊戲中的其他玩家看到該玩家的活動。您的遊戲可以讓其他玩家加入進行中的遊戲。如果玩家想要加入您遊戲的活動，而遊戲未在執行中，則會啟動遊戲並將連接字串傳遞給它。若要了解此函式的使用方式，請參閱多人遊戲活動的範例程式碼中活動一節的「設定活動」。