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

# AddBlobToGpuHangDumpX (consoles XBOX Series)

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

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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_sethangcallbacksx) quando a GPU estiver travada.

## Sintaxe

```cpp theme={null}
HRESULT AddBlobToGpuHangDumpX(
  D3D12_GPU_VIRTUAL_ADDRESS Address,
  UINT SizeBytes,
  UINT64 Metadata
)
```

### 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](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues). 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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_sethangcallbacksx) 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](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members)\
[ID3D12Device8](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/id3d12device8)\
[Investigação de travamentos para XBOX (HIX)](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/hix/hix)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [XBOX Hang Investigation Tool (XHIT)](/pt-BR/tools/tools-console/xhit/index.md)
- [SetWatsonDumpEnablement](/pt-BR/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/methods/id3d12deviceremovedextendeddatasettings_setwatsondumpenablement_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE](/pt-BR/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_public.md)
- [Ferramenta Investigação de travamentos para XBOX (HIX)](/pt-BR/tools/tools-console/hix/index.md)