> ## 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.

# XPackageGetWriteStats

> XPackageGetWriteStats

# XPackageGetWriteStats

Obtém as estatísticas de gravação de saída (writeStats).

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XPackageGetWriteStats(  
         XPackageWriteStats* writeStats  
)  
```

<a id="parametersSection" />

### Parâmetros

*writeStats*   \_Out\_\
Tipo: [XPackageWriteStats\*](/pt-BR/reference/system/xpackage/structs/xpackagewritestats)

Ponteiro para uma estrutura `XPackageWriteStats`.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT. A função preenche *writeStats* somente se for bem-sucedida.

<a id="remarksSection" />

## Comentários

Essa função chama o sistema para retornar as estatísticas de gravação referentes ao tempo do intervalo atual. Se for bem-sucedida, ela preenche a estrutura `XPackageWriteStats` com as estatísticas de gravação de saída.

Ela recupera as estatísticas de gravação atuais do título, incluindo a duração do intervalo atual, o tempo decorrido no intervalo atual, o orçamento total desse intervalo e a quantidade gravada. Essas estatísticas podem ser usadas para garantir que o jogo não grave conteúdo demais em um intervalo, o que dispararia um evento que pode impedir o jogo de passar na certificação.

| **writeStats** | **Descrição** |
| - | - |
| **Interval** | Um valor de 64 bits que indica o tempo total (em milissegundos) do intervalo de gravação atual. |
| **Budget** | Um valor de 64 bits que indica a quantidade de dados que o sistema permitirá que o título grave no intervalo atual sem fazer com que um evento de excesso seja registrado. |
| **Bytes Written** | Um valor de 64 bits que indica o número de bytes gravados pelo título no intervalo atual. |
| **Time Elapsed** | Um valor de 64 bits que indica o tempo (em milissegundos) decorrido no intervalo atual. |

<Note>O primeiro intervalo monitorado pelo título não atualiza *Time Elapsed* e não fará com que um evento de excesso seja registrado ao ultrapassar o *Budget*. Depois que o *Budget* total de dados tiver sido gravado uma vez, o intervalo será redefinido e o valor de *Time Elapsed* passará a ser atualizado. Os intervalos futuros no título serão então redefinidos com base nos tempos de intervalo e dispararão o evento de excesso se o *Budget* for ultrapassado.</Note>

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** XPackage.h

**Biblioteca:** xgameruntime.lib

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

<a id="seealsoSection" />

## Documentação conceitual

* [Armazenamento local no console XBOX](/pt-BR/build/console-features/storage/local-storage)

## Confira também

[Introdução ao empacotamento de títulos para consoles XBOX](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-console)\
[Visão geral do empacotamento](/pt-BR/build/core-features/common/packaging/overviews/packaging)\
[XPackage](/pt-BR/reference/system/xpackage/xpackage_members)


## Related topics

- [XPackageGetWriteStats](/reference/system/xpackage/functions/xpackagegetwritestats.md)
- [XPackageWriteStats](/reference/system/xpackage/structs/xpackagewritestats.md)
