Skip to main content

XPackageChangeChunkInstallOrder

Specifies which selected chunks are to be installed first.

Syntax

Parameters

packageIdentifier   _In_z_
Type: char*
A string that uniquely identifies the installed package on the disk. For more information about package identifiers, see Manage and license downloadable content (DLC). selectorCount   _In_
Type: uint32_t
The number of selectors in the selectors parameter. selectors   _In_reads_(selectorCount)
Type: XPackageChunkSelector*
An array of selectors that specifies the type of chunks to be affected.

Return value

Type: HRESULT HRESULT success or error code.

Remarks

This function isn’t safe to call on a time-sensitive thread. For more information, see Time-sensitive threads.
XPackageChangeChunkInstallOrder updates the chunks selected by the specified selector to be placed first in the installation queue. This can take a selector, not just an array of chunk IDs. You can pass more complex selectors here, and the chunks that make them up will all be pushed to the front of the queue. You can call XPackageChangeChunkInstallOrder at any time, not only when the chunks are not installed. If the chunks are already installed, XPackageChangeChunkInstallOrder ignores them. The same is true when you provide chunks that, due to intelligent delivery, are not scheduled to be installed at all. In the following example, to keep the user playing, the game must access a file called “soon”. Function PrioritizeChunk is defined and checks the chunk’s current installation status. If the chunk is not already installed, the function asks the streaming system to install it and returns an installation monitor that can monitor the chunk’s progress. If the chunk is already installed, the function returns a null monitor.

Requirements

Header: XPackage.h Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

Conceptual documentation

See also

XPackage
Streaming Installation and Intelligent Delivery
Last modified on August 20, 2026