Passer au contenu principal
Crée un tas de diagnostic à usage spécial dans la mémoire système à partir d’un objet de mappage de fichier. Le tas créé peut persister même en cas d’erreur GPU ou de scénario de retrait de l’appareil.

Syntaxe

Paramètres

hFileMapping
Type : HANDLE
Le handle de l’objet de mappage de fichier à utiliser pour créer le tas. riid
Type : const IID &
L’identificateur global unique (GUID) de l’interface de tas (ID3D12Heap). Le REFIID, ou GUID, de l’interface du tas peut être obtenu à l’aide de la macro __uuidof(). Par exemple, __uuidof(ID3D12Heap) récupérera le GUID de l’interface d’un tas. ppvHeap [out]
Type : void **
SAL : COM_Outptr Un pointeur vers un bloc de mémoire. En cas de réussite, le runtime D3D12 écrira dans le bloc de mémoire un pointeur vers le tas nouvellement ouvert. Le type du pointeur dépend du paramètre riid fourni.

Valeur de retour

Type : HRESULT Cette méthode retourne E_OUTOFMEMORY si la mémoire est insuffisante pour ouvrir le tas existant. Consultez Codes de retour Direct3D 12 pour connaître les autres valeurs de retour possibles.

Remarques

Le tas est créé dans la mémoire système et permet l’accès par le processeur. Il englobe toute la région VirtualAlloc. Les tas peuvent être utilisés pour des ressources placées et réservées, de façon aussi orthogonale que les autres tas. Des restrictions peuvent toutefois exister en fonction des indicateurs que l’application ne peut pas choisir.

Configuration requise

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

Voir aussi

Interface ID3D12Device3
Dernière modification le 6 octobre 2026