Skip to main content

XGameSaveEnumerateBlobInfoByName

Recupera as informações de blob para o conteúdo de um XGameSaveContainer, limitado aos blobs que compartilham um prefixo com o parâmetro blobNamePrefix.

Sintaxe

Parâmetros

container   _In_
Tipo: XGameSaveContainerHandle
Identificador para o XGameSaveContainer que contém os blobs a serem enumerados. blobNamePrefix   _In_opt_z_
Tipo: char*
prefixo usado para filtrar os blobs recuperados. context   _In_opt_
Tipo: void*
Ponteiro para o objeto de chamada para contexto. callback   _In_
Tipo: XGameSaveBlobInfoCallback*
Função a ser chamada para cada blob que corresponde ao prefixo; retorne false para interromper a enumeração. Use-a para iterar sobre o XGameSaveBlobInfo e verificar o êxito da chamada de função.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Embora seja seguro chamar esta função em uma thread sensível ao tempo, o XGameSaveBlobInfoCallback pode causar atrasos, dependendo do que o título faz dentro do retorno de chamada. Por exemplo, copiar dados do retorno de chamada não tem problema; no entanto, fazer qualquer chamada não sensível ao tempo pode atrasar o retorno do retorno de chamada. Para obter mais informações, consulte Threads sensíveis ao tempo.
Os blobs contêm os dados recuperáveis reais que compõem um contêiner. Enumerar os blobs permitirá que você veja todos os dados disponíveis dentro do contêiner. Você pode usar XGameSaveEnumerateBlobInfo para enumerar todos os blobs de um contêiner em vez de filtrar por um prefixo.

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
XGameSaveEnumerateBlobInfo
Depuração de salvamentos de jogos
Last modified on October 6, 2026