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

# CreatePlacedResourceX (família XBOX One)

> CreatePlacedResourceX (consoles da família XBOX One): posiciona um recurso inteiro. Referência da API gráfica do Direct3D 12 para desenvolvimento de jogos XBOX.

Posiciona um recurso inteiro.

## Sintaxe

```cpp theme={null}
HRESULT CreatePlacedResourceX(  
         D3D12_GPU_VIRTUAL_ADDRESS ResourceLocation,  
         const D3D12_RESOURCE_DESC* pDesc,  
         D3D12_RESOURCE_STATES InitialState,  
         const D3D12_CLEAR_VALUE* pOptimizedClearValue,  
         REFIID riid,  
         void** ppvResource  
)  
```

### Parâmetros

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

O endereço do recurso (um UINT64).

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

A descrição do recurso como um ponteiro para uma estrutura **D3D12\_RESOURCE\_DESC**.

*InitialState*   <br />Tipo: [D3D12\_RESOURCE\_STATES](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_resource_states)

O estado inicial de uso do recurso, como uma combinação OR bit a bit de constantes de enumeração **D3D12\_RESOURCE\_STATES**. Para o XBOX One, a enumeração **D3D12\_RESOURCE\_STATES** tem constantes de enumeração adicionais e específicas do XBOX, como uma indicação de se uma cor compactada deve ser preservada.

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

Otimizações de cor que podem beneficiar algumas arquiteturas de GPU que armazenam uma cor de limpeza em seus descritores de recurso. Um ponteiro para uma estrutura **D3D12\_CLEAR\_VALUE**.

*riid*   <br />Tipo: REFIID

O identificador global exclusivo (GUID) da interface de 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

Este método é usado em conjunto com [CopyPageMappingsX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copypagemappingsx) para atualizar mapeamentos de recursos em tempo de execução.

Usar **CreatePlacedResourceX** é semelhante a mapear totalmente um recurso reservado para um deslocamento dentro de um heap, mas o espaço de endereço virtual associado a um heap também pode ser reutilizado.

Para obter mais informações, consulte [CreatePlacedResource](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-createplacedresource).

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[ID3D12Device](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [CreatePlacedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
- [CreateCommittedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md)
- [CreateReservedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)
- [CreatePlacedResource2 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreateShaderResourceView](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createshaderresourceview_public.md)