Skip to main content
Posiciona um componente de um recurso (sub-recurso).

Sintaxe

Parâmetros

pComponentLocations _In_
Tipo: D3D12XBOX_COMPONENT_PLACED_ADDRESSES*
Os locais do componente como uma estrutura D3D12XBOX_COMPONENT_PLACED_ADDRESSES. pDesc _In_
Tipo: D3D12_RESOURCE_DESC1*
A descrição do recurso ou sub-recurso, como um ponteiro para uma estrutura D3D12_RESOURCE_DESC1. InitialLayout
Tipo: D3D12_BARRIER_LAYOUT
O layout inicial do recurso de textura; D3D12_BARRIER_LAYOUT::D3D12_BARRIER_LAYOUT_UNDEFINED para buffers. pOptimizedClearValue _In_opt_
Tipo: D3D12_CLEAR_VALUE*
O valor otimizado a ser usado para limpar o componente, como um ponteiro para uma estrutura D3D12_CLEAR_VALUE. riid
Tipo: REFIID
O identificador global exclusivo (GUID) da interface do recurso, ID3D12Resource. Para recuperar o REFIID (ou GUID) da interface do recurso, use a macro __uuidof(). Por exemplo, para obter o GUID da interface de uma lista de comandos, faça o seguinte:
ppvResource _Outptr_opt_
Tipo: void**
O recurso.

Valor retornado

Tipo: HRESULT Um dos códigos de retorno do Direct3D 12.

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. A biblioteca XG fornece um layout para as configurações de FMask e CMask. CreateComponentPlacedResourceX2 é semelhante a 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, este método recebe um 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
Biblioteca: d3d12_xs.lib
Plataformas com suporte: consoles XBOX Series

Confira também

ID3D12Device11 CreateComponentPlacedResourceX CreateComponentPlacedResourceX1 CreatePlacedResourceX1
Last modified on October 6, 2026