Passer au contenu principal
Inscrit un pool de pages afin qu’il puisse être utilisé comme source pour CopyPageMappingsX et des fonctions similaires.

Syntaxe

Paramètres

PagePoolAddress   _In_
Type : D3D12_GPU_VIRTUAL_ADDRESS
Adresse de base du pool de pages. L’adresse doit être alignée sur une page de 64 Ko et se trouver dans la mémoire graphique, MEM_GRAPHICS. PagePoolPageCount   _In_
Type : UINT
Nombre de pages à allouer dans le pool de pages. Ce nombre doit être différent de zéro, et la plage doit spécifier de la mémoire entièrement mappée : soit de la mémoire système, soit de l’ESRAM. pPagePoolHandle   _Out_
Type : HANDLE*
Adresse d’un bloc de mémoire qui reçoit le handle du pool de pages en cas d’inscription réussie. Le handle peut être utilisé ultérieurement pour désinscrire le pool de pages à l’aide de UnregisterPagePoolX.

Valeur de retour

Type : HRESULT E_OUTOFMEMORY si la mémoire est insuffisante pour le pool de pages. E_INVALIDARG si les arguments ne sont pas valides ou si l’un d’eux correspond aux codes de retour Direct3D 12.

Remarques

L’inscription d’un pool de pages verrouille les pages physiques du pool afin qu’elles ne puissent pas être libérées par inadvertance tant que le pool de pages n’est pas démappé. Toute tentative d’utilisation d’un pool de pages sans l’avoir préalablement inscrit provoque des erreurs dans les fonctions de mappage de pages GPU. Les pools de pages ne doivent être inscrits qu’une seule fois, pour établir le pool ; il n’est pas nécessaire d’inscrire à plusieurs reprises le même pool de pages.

Configuration requise

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

Voir aussi

ID3D12Device
CopyPageMappingsX
UnregisterPagePoolX
Dernière modification le 6 octobre 2026