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

# CreateComponentPlacedResourceX1 (famille XBOX One)

> Place un composant d'une ressource (sous-ressource) décrit par D3D12XBOX_RESOURCE_DESC.

Place un composant d'une ressource (sous-ressource) décrit par une [D3D12XBOX\_RESOURCE\_DESC](/fr-CA/reference/graphics/d3d12_x/structs/d3d12xbox_resource_desc).

## Syntaxe

```cpp theme={null}
HRESULT CreateComponentPlacedResourceX1(  
         const D3D12XBOX_COMPONENT_PLACED_ADDRESSES* pComponentLocations,  
         const D3D12XBOX_RESOURCE_DESC* pDesc,  
         D3D12_RESOURCE_STATES InitialState,  
         const D3D12_CLEAR_VALUE* pOptimizedClearValue,  
         REFIID riid,  
         void** ppvResource  
)  
```

### Paramètres

*pComponentLocations*   \_In\_<br />Type : [D3D12XBOX\_COMPONENT\_PLACED\_ADDRESSES\*](/fr-CA/reference/graphics/d3d12_x/structs/d3d12xbox_component_placed_addresses)

Les emplacements des composants, sous forme de structure **D3D12XBOX\_COMPONENT\_PLACED\_ADDRESSES**.

*pDesc*   \_In\_<br />Type : [D3D12XBOX\_RESOURCE\_DESC\*](/fr-CA/reference/graphics/d3d12_x/structs/d3d12xbox_resource_desc)

La description de la ressource ou de la sous-ressource, sous forme de pointeur vers une structure **D3D12XBOX\_RESOURCE\_DESC**.

*InitialState*   <br />Type : [D3D12\_RESOURCE\_STATES](/fr-CA/reference/graphics/d3d12_x/enums/d3d12_resource_states)

L'état d'utilisation initial du composant de ressource, sous forme de combinaison OR au niveau du bit de constantes d'énumération D3D12\_RESOURCE\_STATES. Pour la XBOX One, l'énumération **D3D12\_RESOURCE\_STATES** comporte des constantes d'énumération supplémentaires propres à XBOX, par exemple une indication permettant de savoir si une couleur compressée doit être conservée.

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

La valeur optimisée à utiliser pour effacer le composant, sous forme de pointeur vers une structure **D3D12\_CLEAR\_VALUE**.

*riid*   <br />Type : REFIID

L'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

Utilisez **CreateComponentPlacedResourceX1** pour créer, au moment de l'exécution, les ressources hors ligne et de placement que vous pouvez prétraiter à l'aide de la [bibliothèque XG](/fr-CA/reference/graphics/xg__NR/xg_members). La **bibliothèque XG** fournit une disposition pour les paramètres FMask et CMask.

**CreateComponentPlacedResourceX1** est similaire à [CreatePlacedResourceX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createplacedresourcex), mais permet au titre de spécifier jusqu'à quatre adresses virtuelles distinctes qui représentent les différentes parties de la ressource.

## Configuration requise

**En-tête :** d3d12\_x.h

**Bibliothèque :** d3d12\_x.lib

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[ID3D12Device](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [CreatePlacedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
- [CreatePlacedResource2 (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreatePlacedResource2 (consolas XBOX Series)](/es/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreatePlacedResource2 (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreatePlacedResource2 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)