ID3D12Device3::OpenExistingHeapFromFileMapping, méthode (d3d12.h)

Article
08/23/2023

Crée un tas de diagnostic à usage spécial dans la mémoire système à partir d’un objet de mappage de fichiers. Le tas créé peut persister même en cas de scénario de panne gpu ou de suppression d’appareil.

Syntaxe

HRESULT OpenExistingHeapFromFileMapping(
        HANDLE hFileMapping,
        REFIID riid,
  [out] void   **ppvHeap
);

Paramètres

hFileMapping

Type : HANDLE

Handle de l’objet de mappage de fichiers à utiliser pour créer le tas.

riid

Type : REFIID

Identificateur global unique (GUID) pour 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ère le GUID de l’interface dans un tas.

[out] ppvHeap

Type : void**

SAL : COM_Outptr

Pointeur vers un bloc de mémoire. En cas de réussite, le runtime D3D12 écrit un pointeur vers le tas nouvellement ouvert dans le bloc de mémoire. Le type du pointeur dépend du paramètre riid fourni.

Valeur retournée

Type : HRESULT

Cette méthode retourne E_OUTOFMEMORY si la mémoire est insuffisante pour ouvrir le tas existant. Pour obtenir d’autres valeurs de retour possibles, consultez Codes de retour Direct3D 12 .

Notes

Le tas est créé dans la mémoire système et autorise l’accès au processeur. Il encapsule l’ensemble de la région VirtualAlloc.

Les tas peuvent être utilisés pour les ressources placées et réservées, aussi orthogonalement que d’autres tas. Des restrictions peuvent toujours exister en fonction des indicateurs qui ne peuvent pas être choisis par l’application.

Spécifications


Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
Plateforme cible	Windows
En-tête	d3d12.h
Bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

Interface ID3D12Device3

Partager via