Skip to main content

XPackageChangeChunkInstallOrder

指定要優先安裝的選取區塊。

語法

參數

packageIdentifier   _In_z_
類型:char*
唯一識別磁碟上已安裝套件的字串。如需套件識別碼的詳細資訊,請參閱管理可下載內容 (DLC) 及授權。 selectorCount   _In_
類型:uint32_t
selectors 參數中的選取器數目。 selectors   _In_reads_(selectorCount)
類型:XPackageChunkSelector*
指定受影響區塊類型的選取器陣列。

傳回值

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

備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
XPackageChangeChunkInstallOrder 會將指定選取器所選取的區塊更新為排在安裝佇列的最前面。此函式可以接受選取器,而不只是區塊識別碼的陣列。您可以在此傳遞更複雜的選取器,而構成這些選取器的區塊都會被推到佇列的最前面。 您可以隨時呼叫 XPackageChangeChunkInstallOrder,不只是在區塊尚未安裝時。如果區塊已經安裝,XPackageChangeChunkInstallOrder 會忽略它們。當您提供因 Intelligent Delivery 而完全未排定安裝的區塊時,也是如此。 在下列範例中,為了讓使用者持續遊玩,遊戲必須存取名為 “soon” 的檔案。這裡定義了 PrioritizeChunk 函式,用來檢查區塊目前的安裝狀態。如果區塊尚未安裝,該函式會要求串流系統安裝它,並傳回可監視區塊進度的安裝監視器。如果區塊已經安裝,該函式會傳回 null 監視器。

需求

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

概念文件

另請參閱

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