Skip to main content

XPackageInstallChunksAsync

開始安裝區塊。

語法

參數

packageIdentifier   _In_z_
類型:char*
可唯一識別磁碟上已安裝套件的字串。如需套件識別碼的詳細資訊,請參閱管理可下載內容 (DLC) 並授權。 selectorCount   _In_
類型:uint32_t
selectors 參數中的選取器數目。 selectors   _In_reads_(selectorCount)
類型:XPackageChunkSelector*
指定要安裝之區塊的選取器陣列。 minimumUpdateIntervalMs   _In_
類型:uint32_t
更新之間的間隔,以毫秒為單位。 suppressUserConfirmation   _In_
類型:bool
如果要安裝的區塊超過預設大小,將會顯示確認提示。如果 suppressUserConfirmation 為 true,則不會顯示提示,且安裝會如同使用者已接受般繼續進行。這可讓遊戲呈現自己的 UI。如果遊戲使用此功能,也應該呼叫 XPackageEstimateDownloadSize 以取得將呈現給使用者的大小。XPackageEstimateDownloadSize 也會傳回布林值,表示大小是否大到需要顯示提示。如果需要下載確認,遊戲必須使用自己的 UI 顯示確認,或讓 XPackageInstallChunks 顯示確認。 asyncBlock   _Inout_
類型:XAsyncBlock*
用來監視非同步呼叫狀態的 XAsyncBlock。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

XPackageInstallChunks 有非同步變體。安裝區塊時,可能會提示使用者接受下載大小。 此範例示範如何使用非同步 API 安裝 BigMaps:

需求

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

概念文件

另請參閱

XPackage
串流安裝和 Intelligent Delivery
XPackageInstallChunks
Last modified on October 6, 2026