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

> Ajoute un blob de mémoire et des métadonnées au fichier de vidage de blocage (.hix). Appelez cette fonction uniquement à partir de la fonction D3D12XBOX_HANGBEGINCALLBACK lorsque le GPU est bloqué.

Ajoute un blob de mémoire et des métadonnées au fichier de vidage de blocage (.hix). Appelez cette fonction uniquement à partir de la fonction [D3D12XBOX\_HANGBEGINCALLBACK](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_sethangcallbacksx) lorsque le GPU est bloqué.

## Syntaxe

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

### Paramètres

*Address*\
Type : D3D12\_GPU\_VIRTUAL\_ADDRESS \_In\_

Adresse virtuelle GPU à laquelle ajouter le blob.

*SizeBytes*\
Type : UINT \_In\_

Taille du blob à ajouter, en octets.

*Metadata*\
Type : UINT64 \_In\_

Métadonnées définies par l'utilisateur à associer au blob.

### Valeur de retour

Type : HRESULT

Retourne S\_OK en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes de retour Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues). Un message d'erreur descriptif est également affiché avec le pilote validé.

## Remarques

Les titres peuvent appeler cette API plusieurs fois à partir de la fonction [D3D12XBOX\_HANGBEGINCALLBACK](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_sethangcallbacksx) pour ajouter plusieurs blobs au vidage de blocage. Le fait de transmettre des métadonnées uniques pour chaque blob permet de les identifier facilement lors de l'analyse hors ligne du blocage. Les titres peuvent récupérer la mémoire du blob après avoir appelé cette API. Une limite de 2 Mo est imposée sur la taille totale des blobs et des métadonnées.

## Configuration requise

**En-tête :** d3d12\_xs.h\
**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[Membres de d3d12\_xs](/fr-CA/reference/graphics/d3d12_xs/d3d12_xs_members)\
[ID3D12Device8](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/id3d12device8)\
[Analyse des blocages pour XBOX (HIX)](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/hix/hix)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [XBOX Hang Investigation Tool (XHIT)](/fr-CA/tools/tools-console/xhit/index.md)
- [Outil Hang Investigation for XBOX (HIX)](/fr-CA/tools/tools-console/hix/index.md)
- [SetWatsonDumpEnablement](/fr-CA/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/methods/id3d12deviceremovedextendeddatasettings_setwatsondumpenablement_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE](/fr-CA/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_public.md)