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

# CreatePlacedResourceX1 (consoles XBOX Series)

> CreatePlacedResourceX1 (consoles XBOX Series) — Place une ressource entière. Référence de l'API graphique Direct3D 12 pour le développement de jeux XBOX.

Place une ressource entière.

## Syntaxe

```cpp theme={null}
HRESULT CreatePlacedResourceX1(  
         D3D12_GPU_VIRTUAL_ADDRESS ResourceLocation,
         const D3D12_RESOURCE_DESC1* pDesc,
         D3D12_BARRIER_LAYOUT InitialLayout,
         const D3D12_CLEAR_VALUE* pOptimizedClearValue,
         REFIID riid,  
         void** ppvResource  
)  
```

### Paramètres

*ResourceLocation*   \_In\_<br />Type : D3D12\_GPU\_VIRTUAL\_ADDRESS

Adresse de la ressource (un UINT64).

*pDesc*   \_In\_<br />Type : [D3D12\_RESOURCE\_DESC1\*](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_resource_desc1)

Description de la ressource, sous forme de pointeur vers une structure **D3D12\_RESOURCE\_DESC1**.

*InitialLayout*   <br />Type : D3D12\_BARRIER\_LAYOUT

Disposition initiale de la ressource de texture; **D3D12\_BARRIER\_LAYOUT::D3D12\_BARRIER\_LAYOUT\_UNDEFINED** pour les mémoires tampons.

*pOptimizedClearValue*   \_In\_opt\_<br />Type : [D3D12\_CLEAR\_VALUE\*](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_clear_value)

Optimisations de couleur dont peuvent bénéficier certaines architectures GPU qui stockent une couleur d'effacement dans leurs descripteurs de ressources. Pointeur vers une structure **D3D12\_CLEAR\_VALUE**.

*riid*   <br />Type : REFIID

Identificateur global unique (GUID) de l'interface de ressource, [ID3D12Resource](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nn-d3d12-id3d12resource).

Pour récupérer le [REFIID](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oaut/bbde795f-5398-42d8-9f59-3613da03c318) (ou GUID) de l'interface de la ressource, utilisez la macro [\_\_uuidof()](https://learn.microsoft.com/en-us/cpp/cpp/uuidof-operator?view=vs-2019). Par exemple, pour obtenir le GUID de l'interface d'une liste de commandes, procédez comme suit :

```cpp theme={null}
__uuidof(ID3D12Resource)  
```

*ppvResource*   \_Outptr\_opt\_<br />Type : void\*\*

La ressource.

### Valeur de retour

Type : HRESULT

L'un des [codes de retour Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Remarques

Cette méthode est utilisée conjointement avec [CopyPageMappingsX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copypagemappingsx) pour mettre à jour les mappages de ressources au moment de l'exécution.

L'utilisation de **CreatePlacedResourceX1** revient à mapper entièrement une ressource réservée à un décalage dans un tas, mais l'espace d'adressage virtuel associé à un tas peut également être réutilisé.

Contrairement à [CreatePlacedResourceX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createplacedresourcex), cette méthode accepte une structure [D3D12\_RESOURCE\_DESC1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_resource_desc1) afin de permettre l'utilisation d'une région mip de rétroaction d'échantillonneur.

Pour spécifier des adresses virtuelles pour les différentes parties de la ressource, consultez [CreateComponentPlacedResourceX2](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_createcomponentplacedresourcex2)

Pour plus de renseignements, consultez [CreatePlacedResource](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-createplacedresource).

## Configuration requise

**En-tête :** d3d12\_xs.h<br />**Bibliothèque :** d3d12\_xs.lib<br />**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[ID3D12Device11](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/id3d12device11)

[CreatePlacedResourceX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createplacedresourcex)

[CreateComponentPlacedResourceX2](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_createcomponentplacedresourcex2)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [CreatePlacedResource2 (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreateProtectedResourceSession (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createprotectedresourcesession_public.md)
- [CreatePlacedResource](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
- [CreateReservedResource2 (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createreservedresource2_public.md)