> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageChangeChunkInstallOrder

> XPackageChangeChunkInstallOrder

# XPackageChangeChunkInstallOrder

Especifica quais partes selecionadas devem ser instaladas primeiro.

## Sintaxe

```cpp theme={null}
HRESULT XPackageChangeChunkInstallOrder(  
        const char* packageIdentifier,  
        uint32_t selectorCount,  
        XPackageChunkSelector* selectors
)  
```

### Parâmetros

*packageIdentifier*   \_In\_z\_\
Tipo: char\*

Uma cadeia de caracteres que identifica exclusivamente o pacote instalado no disco.  Para obter mais informações sobre identificadores de pacote, consulte [Gerenciar e licenciar conteúdo para download (DLC)](/pt-BR/publishing/xstore-commerce/xstore-dlc).

*selectorCount*   \_In\_\
Tipo: uint32\_t

O número de seletores no parâmetro *selectors*.

*selectors*   \_In\_reads\_(selectorCount)\
Tipo: [XPackageChunkSelector\*](/pt-BR/reference/system/xpackage/structs/xpackagechunkselector)

Uma matriz de seletores que especifica o tipo de partes a serem afetadas.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

<Note>Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

**XPackageChangeChunkInstallOrder** atualiza as partes selecionadas pelo seletor especificado para que sejam colocadas no início da fila de instalação. Ela pode receber um seletor, não apenas uma matriz de IDs de parte. Você pode passar seletores mais complexos aqui, e todas as partes que os compõem serão enviadas para o início da fila.

Você pode chamar **XPackageChangeChunkInstallOrder** a qualquer momento, não apenas quando as partes não estão instaladas. Se as partes já estiverem instaladas, **XPackageChangeChunkInstallOrder** as ignora. O mesmo vale quando você fornece partes que, devido à entrega inteligente, não estão agendadas para serem instaladas.

No exemplo a seguir, para manter o usuário jogando, o jogo precisa acessar um arquivo chamado "soon". A função PrioritizeChunk é definida e verifica o status de instalação atual da parte. Se a parte ainda não estiver instalada, a função solicita ao sistema de streaming que a instale e retorna um monitor de instalação que pode monitorar o progresso da parte. Se a parte já estiver instalada, a função retorna um monitor nulo.

```cpp theme={null}
HRESULT PrioritizeChunk( 
    XTaskQueueHandle queue, uint32_t chunkId, XPackageInstallationMonitorHandle* monitor) 
{ 
    char id[XPACKAGE_IDENTIFIER_MAX_LENGTH]; 
 
    *monitor = nullptr; 
    HRESULT hr = XPackageGetCurrentProcessPackageIdentifier(_countof(id), id); 
    if (FAILED(hr)) return hr; 



 
    XPackageChunkSelector selector; 
    selector.type = XPackageChunkSelectorType::Chunk; 
    selector.chunkId = chunkId; 
 
    hr = XPackageCreateInstallationMonitor(id, 1, &selector, 1000, queue, monitor); 
 
    if (SUCCEEDED(hr)) 
    { 
        XPackageInstallationProgress progress; 
        XPackageGetInstallationProgress(*monitor, &progress); 
    }

    if (!progress.completed) 
    { 
        hr = XPackageChangeChunkInstallOrder(id, 1, &selector); 
    } 
 
    if (progress.completed || FAILED(hr)) 
    { 
        XPackageCloseInstallationMonitorHandle(*monitor); 
        *monitor = nullptr; 
    } 
 
    return hr; 
} 
```

## Requisitos

**Cabeçalho:** XPackage.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XPackage](/pt-BR/reference/system/xpackage/xpackage_members)\
[Instalação por streaming e Intelligent Delivery](/pt-BR/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [XPackageChangeChunkInstallOrder](/ja-jp/reference/system/xpackage/functions/xpackagechangechunkinstallorder.md)
- [XPackage](/reference/system/xpackage/xpackage_members.md)
- [Dynamic reordering of chunks](/build/core-features/common/packaging/packaging-chunkreordering.md)