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

# CreateComponentPlacedResourceX2 (consoles XBOX Series)

> CreateComponentPlacedResourceX2 (consoles XBOX Series) — Posiciona um componente de um recurso (sub-recurso). Referência de elementos gráficos do Direct3D 12 para XBOX.

Posiciona um componente de um recurso (sub-recurso).

## Sintaxe

```cpp theme={null}
HRESULT CreateComponentPlacedResourceX2(  
         const D3D12XBOX_COMPONENT_PLACED_ADDRESSES* pComponentLocations,  
         const D3D12_RESOURCE_DESC1* pDesc,  
         D3D12_BARRIER_LAYOUT InitialLayout,  
         const D3D12_CLEAR_VALUE* pOptimizedClearValue,  
         REFIID riid,  
         void** ppvResource  
)  
```

### Parâmetros

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

Os locais do componente como uma estrutura **D3D12XBOX\_COMPONENT\_PLACED\_ADDRESSES**.

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

A descrição do recurso ou sub-recurso, como um ponteiro para uma estrutura **D3D12\_RESOURCE\_DESC1**.

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

O layout inicial do recurso de textura; **D3D12\_BARRIER\_LAYOUT::D3D12\_BARRIER\_LAYOUT\_UNDEFINED** para buffers.

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

O valor otimizado a ser usado para limpar o componente, como um ponteiro para uma estrutura **D3D12\_CLEAR\_VALUE**.

*riid*   <br />Tipo: REFIID

O identificador global exclusivo (GUID) da interface do recurso, [ID3D12Resource](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nn-d3d12-id3d12resource).

Para recuperar o [REFIID](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oaut/bbde795f-5398-42d8-9f59-3613da03c318) (ou GUID) da interface do recurso, use a macro [\_\_uuidof()](https://learn.microsoft.com/en-us/cpp/cpp/uuidof-operator?view=vs-2019). Por exemplo, para obter o GUID da interface de uma lista de comandos, faça o seguinte:

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

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

O recurso.

### Valor retornado

Tipo: HRESULT

Um dos [códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Use **CreateComponentPlacedResourceX2** para criar, em tempo de execução, os recursos offline e de posicionamento que você pode pré-processar usando a [biblioteca XG](/pt-BR/reference/graphics/xg__NR/xg_members). A **biblioteca XG** fornece um layout para as configurações de FMask e CMask.

**CreateComponentPlacedResourceX2** é semelhante a [CreatePlacedResourceX1](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_createplacedresourcex1), mas permite que o título especifique até quatro endereços virtuais separados que representam as partes individuais do recurso.

Ao contrário de [CreateComponentPlacedResourceX1](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcomponentplacedresourcex1), este método recebe um [D3D12\_RESOURCE\_DESC1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_resource_desc1) para permitir o uso de uma região de mip de comentários do amostrador (sampler feedback).

## Requisitos

**Cabeçalho:** d3d12\_xs.h<br />**Biblioteca:** d3d12\_xs.lib<br />**Plataformas com suporte:** consoles XBOX Series

## Confira também

[ID3D12Device11](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/id3d12device11)

[CreateComponentPlacedResourceX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcomponentplacedresourcex)

[CreateComponentPlacedResourceX1](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcomponentplacedresourcex1)

[CreatePlacedResourceX1](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_createplacedresourcex1)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CreatePlacedResource2 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreateProtectedResourceSession (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createprotectedresourcesession_public.md)
- [CreatePlacedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
- [CreateReservedResource2 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createreservedresource2_public.md)