Skip to main content
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é.

Syntaxe

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. 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 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
ID3D12Device8
Analyse des blocages pour XBOX (HIX)
Last modified on October 6, 2026