Skip to main content

XPackageFindChunkAvailability

傳回符合指定選取器之區塊集合的最低可用性。

語法

參數

packageIdentifier   _In_z_
類型:char*
唯一識別磁碟上已安裝套件的字串。如需套件識別碼的詳細資訊,請參閱管理可下載內容 (DLC) 及授權。 selectorCount   _In_
類型:uint32_t
selectors 參數中的選取器數目。 selectors   _In_reads_opt_(selectorCount)
類型:XPackageChunkSelector*
指定要檢查之區塊的選取器陣列。 availability   _Out_
類型:XPackageChunkAvailability*
傳回時,列出區塊的可用性。

傳回值

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

備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
XPackageFindChunkAvailability 會接受區塊選取器陣列,尋找相關聯的區塊,然後傳回這些區塊的最低可用性。可用性依下列值區分:
  • Ready:區塊已安裝,可以讀取。
  • Pending:區塊尚未安裝,但將會安裝。
  • Installable:區塊不會安裝,但可以下載。
  • Unavailable:區塊無法下載。
下列範例接受賽車遊戲的賽道名稱,如果賽道尚未安裝,則列印該賽道的下載大小:

需求

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

概念文件

另請參閱

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