ID3D12Device3::OpenExistingHeapFromAddress, méthode (d3d12.h)
Crée un tas de diagnostic à usage spécial dans la mémoire système à partir d’une adresse. Le tas créé peut persister même en cas de scénario de panne gpu ou de suppression d’appareil.
Syntaxe
HRESULT OpenExistingHeapFromAddress(
[in] const void *pAddress,
REFIID riid,
[out] void **ppvHeap
);
Paramètres
[in] pAddress
Type : const void*
Adresse utilisée 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
| Plateforme cible | Windows |
| En-tête | d3d12.h |
| Bibliothèque | D3d12.lib |
| DLL | D3d12.dll |