Skip to main content

XPackageGetWriteStats

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

Sintaxe

Parâmetros

writeStats   _Out_
Tipo: XPackageWriteStats*
Ponteiro para uma estrutura XPackageWriteStats.

Valor retornado

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

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

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

Confira também

Introdução ao empacotamento de títulos para consoles XBOX
Visão geral do empacotamento
XPackage
Last modified on October 6, 2026