Passer au contenu principal
Inscrit un emplacement mémoire utilisé pour la synchronisation personnalisée des clôtures auprès de l’infrastructure utilisée pour signaler les blocages du GPU.

​
Syntaxe

​
Paramètres

FenceGpuAddress   _In_
Type : D3D12_GPU_VIRTUAL_ADDRESS L’adresse de la clôture. pName   _In_z_
Type : LPCWSTR Lorsque le nom est stocké dans la table des emplacements de clôtures personnalisées du pilote, sa longueur, y compris le caractère null de fin, est limitée à 24 caractères.

​
Valeur de retour

Type : UINT32 La valeur de retour est un handle qui peut être utilisé pour désinscrire l’emplacement mémoire à l’aide de UnregisterCustomFenceLocationX. Si la valeur -1 (0xFFFFFFFF) est retournée, l’inscription a échoué.

​
Remarques

Si un blocage du GPU pendant l’attente d’une clôture est détecté, l’adresse attendue est comparée à la liste des emplacements de clôtures personnalisées inscrits, afin d’annoter le rapport de blocage avec les noms des emplacements mémoire. L’inscription des clôtures personnalisées ne fonctionne que dans les versions de débogage et instrumentées du pilote graphique. Jusqu’à 256 emplacements peuvent être inscrits à la fois. La définition du nom d’un objet d’API ID3D12Fence à l’aide de ID3D12Object::SetName utilisera l’une de ces 256 entrées.

​
Configuration requise

En-tête : d3d12_x.h Bibliothèque : d3d12_x.lib Plateformes prises en charge : famille XBOX One

​
Voir aussi

ID3D12Device
Dernière modification le 6 octobre 2026