> ## 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 suppression de l'appareil.

## Syntaxe

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

### Paramètres

*hFileMapping*<br />Type : HANDLE

Handle de l'objet de mappage de fichier à utiliser pour créer le tas.

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

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

Le **REFIID**, ou **GUID**, de l'interface vers le tas peut être obtenu à l'aide de la macro **\_\_uuidof()**. Par exemple, **\_\_uuidof(ID3D12Heap)** récupère le **GUID** de l'interface vers 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>

Pointeur vers un bloc de mémoire. En cas de réussite, le runtime D3D12 écrit 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 renvoyée

Type : HRESULT

Cette méthode renvoie **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 autorise l'accès du processeur. Il englobe toute la région VirtualAlloc.

Les tas peuvent être utilisés pour les ressources placées et réservées, de manière aussi orthogonale que les autres tas. Des restrictions peuvent toutefois subsister en fonction des indicateurs qui ne peuvent pas être choisis par l'application.

## 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/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3)


## Related topics

- [OpenExistingHeapFromAddress](/fr/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromaddress_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](/fr/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [OpenSharedHandle](/fr/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)