> ## 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.

# OpenExistingHeapFromFileMapping

> 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.

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

```cpp theme={null}
HRESULT OpenExistingHeapFromFileMapping(
    HANDLE hFileMapping,
    const IID & riid,
    void  ppvHeap
)
```

### Paramètres

*hFileMapping*<br />Type : HANDLE

Le handle de l'objet de mappage de fichier à utiliser 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

- [OpenExistingHeapFromAddress](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromaddress_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)
- [Unlink Open Id Connect](/api-reference/account-management/unlink-open-id-connect.md)