Skip to main content
Adiciona um blob de memória e metadados ao arquivo de despejo de travamento (.hix). Chame essa função somente a partir da função D3D12XBOX_HANGBEGINCALLBACK quando a GPU estiver travada.

​
Sintaxe

​
Parâmetros

Address
Tipo: D3D12_GPU_VIRTUAL_ADDRESS _In_ O endereço virtual da GPU no qual adicionar o blob. SizeBytes
Tipo: UINT _In_ O tamanho do blob a ser adicionado, em bytes. Metadata
Tipo: UINT64 _In_ Os metadados definidos pelo usuário a serem associados ao blob.

​
Valor retornado

Tipo: HRESULT Retorna S_OK se bem-sucedido; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de retorno do Direct3D 12. Uma mensagem de erro descritiva também é exibida com o driver validado.

​
Comentários

Os títulos podem chamar essa API várias vezes a partir da função D3D12XBOX_HANGBEGINCALLBACK para adicionar vários blobs ao despejo de travamento. Passar metadados exclusivos para cada blob ajuda a identificá-los facilmente durante a análise offline do travamento. Os títulos podem recuperar a memória do blob depois de chamar essa API. É imposto um limite de 2 MB ao tamanho total dos blobs mais os metadados.

​
Requisitos

Cabeçalho: d3d12_xs.h
Biblioteca: d3d12_xs.lib
Plataformas compatíveis: consoles XBOX Series

​
Confira também

Membros de d3d12_xs
ID3D12Device8
Investigação de travamentos para XBOX (HIX)
Last modified on October 6, 2026