Skip to main content

XGameSaveReadBlobData

Lê os dados de blob de um contêiner.

Sintaxe

Parâmetros

container   _In_
Tipo: XGameSaveContainerHandle
Identificador para o XGameSaveContainer que contém os dados de XGameSaveBlob. blobNames   _In_opt_z_count_(countOfBlobs)
Tipo: char
*
Ponteiro para uma matriz de cadeias de caracteres que representa os nomes de XGameSaveBlob. countOfBlobs   _Inout_
Tipo: uint32_t*
Número de blobs a serem lidos. blobsSize   _In_
Tipo: size_t
Tamanho dos dados de blob alocados; pode ser inferido pela leitura dos metadados do blob. blobData   _Out_writes_bytes_(blobsSize)
Tipo: XGameSaveBlob*
XGameSaveBlob ponteiro para conter os dados de blob. Deve ter memória alocada para armazenar todos os blobs solicitados do contêiner.

Valor retornado

Tipo: HRESULT Resultado da função.

Erros comuns

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_PROVIDED_BUFFER_TOO_SMALL
  • E_GS_BLOB_NOT_FOUND
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Comentários

Não é seguro chamar esta função em uma thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Use esta função para ler os dados em um blob de salvamento de jogo. A função retornará o número de blobs e os dados dentro de um contêiner de blobs. Você pode usá-los para iterar sobre os blobs em um contêiner e ler as informações apropriadas. Há uma versão assíncrona desta função chamada XGameSaveReadBlobDataAsync.

Requisitos

Cabeçalho: XGameSave.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameSave
XGameSaveBlobInfo
XGameSaveReadBlobDataAsync
Depuração de salvamentos de jogos
Last modified on October 6, 2026