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

# D3D12_VIEW_INSTANCING_DESC

> Especifica os parâmetros usados durante a configuração da instanciação de exibição.

Especifica os parâmetros usados durante a configuração da instanciação de exibição.

## Sintaxe

```cpp theme={null}
typedef struct D3D12_VIEW_INSTANCING_DESC
{
    UINT ViewInstanceCount;
    const D3D12_VIEW_INSTANCE_LOCATION  pViewInstanceLocations;
    D3D12_VIEW_INSTANCING_FLAGS Flags;
} D3D12_VIEW_INSTANCING_DESC
```

### Membros

*ViewInstanceCount*\
Tipo: UINT

Especifica o número de exibições a serem usadas, até D3D12\_MAX\_VIEW\_INSTANCE\_COUNT.

*pViewInstanceLocations*\
Tipo: const D3D12\_VIEW\_INSTANCE\_LOCATION \*

O endereço de um local de memória que contém **ViewInstanceCount** estruturas de local de instância de exibição que especificam o local dos detalhes de visor/tesoura e de destino de renderização de cada instância de exibição.

*Flags*\
Tipo: D3D12\_VIEW\_INSTANCING\_FLAGS

Configura a instanciação de exibição com opções adicionais.

## Comentários

A instanciação de exibição é declarada em um PSO usando esta estrutura. A contagem de instâncias de exibição é definida no PSO para permitir a otimização de todo o pipeline com base no número de exibições.

A instanciação de exibição é desabilitada quando não é declarada no PSO ou quando ViewInstanceCount é definido como 0. Quando desabilitada, a renderização se comporta como se a instanciação de exibição estivesse habilitada e ViewInstanceCount estivesse definido como 1; os sombreadores veem apenas o valor 0 em SV\_ViewID e apenas uma instância de exibição é produzida. Isso permite que sombreadores que reconhecem a instanciação de exibição ainda sejam usados em PSOs que a desabilitam. Alguns adaptadores podem dar suporte ao modelo de sombreador 6.1 (que expõe SV\_ViewID), mas não à instanciação de exibição; esses adaptadores ainda devem dar suporte a sombreadores que recebem SV\_ViewID como entrada em PSOs que declaram ViewInstanceCount como 0 ou 1.

O sombreador anterior à rasterização pode gerar valores de SV\_RenderTargetArrayIndex e SV\_ViewportArrayIndex que não precisam depender de SV\_ViewID. Para calcular o índice efetivo final do visor e do destino de renderização para onde os primitivos serão enviados, esses valores, quando presentes, são adicionados aos valores de ViewportArrayIndex e RenderTargetArrayIndex dos locais de instância de exibição declarados no PSO. Se um índice calculado estiver fora do intervalo (ou seja, quando o índice for maior que o número de elementos de visor ou de destino de renderização em suas respectivas matrizes), o índice efetivo se tornará 0.

Para sombreadores que selecionam dinamicamente os índices de visor ou de destino de renderização, um aplicativo pode definir todos os locais de instância de exibição declarados no PSO com um único valor (como 0), para atuar como um índice base uniforme ao qual os valores de SV\_RenderTargetArrayIndex e SV\_ViewportArrayIndex selecionados dinamicamente são adicionados.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Estruturas principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_VIEW_INSTANCING_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_view_instancing_flags_public.md)
- [D3D12_VIEW_INSTANCING_TIER](/pt-BR/reference/graphics/d3d12/enums/d3d12_view_instancing_tier_public.md)
- [D3D12_SHADER_RESOURCE_VIEW_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_shader_resource_view_desc_public.md)
- [D3D12_DEPTH_STENCIL_VIEW_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_depth_stencil_view_desc_public.md)
- [D3D12_CONSTANT_BUFFER_VIEW_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_constant_buffer_view_desc_public.md)