> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenExistingHeapFromAddress

> 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 d'erreur GPU ou de retrait de l'appareil.

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 d'erreur GPU ou de scénario de retrait de l'appareil.

## Syntaxe

```cpp theme={null}
HRESULT OpenExistingHeapFromAddress(
    const void  pAddress,
    const IID & riid,
    void  ppvHeap
)
```

### Paramètres

*pAddress \[in]*<br />Type : const void \*

L'adresse utilisée pour créer le tas.

*riid*<br />Type : const IID &

L'identificateur global unique (**GUID**) de l'interface de tas ([ID3D12Heap](/fr-CA/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public)).

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]*<br />Type : void \*\*

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values?view=vs-2015\&preserve-view=true) : <code>*COM\_Outptr*</code>

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](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) 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<br />**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib<br />**Plateformes prises en charge** : consoles XBOX Series et famille XBOX One

## Voir aussi

[Interface ID3D12Device3](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3)


## Related topics

- [OpenExistingHeapFromFileMapping](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](/fr-CA/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [OpenSharedHandle](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandle_public.md)
- [Update Open Id Connection](/api-reference/authentication/update-open-id-connection.md)
- [XMemCreateWin32Heap](/fr-CA/reference/system/xmem/functions/xmemcreatewin32heap.md)