Passer au contenu principal
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 connexion 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 appliquée à 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 d3d12_xs
ID3D12Device8
Analyse des blocages pour XBOX (HIX)
Dernière modification le 6 octobre 2026