Sintaxe
Parâmetros
Mask [in]Tipo: UINT Uma máscara que especifica quais exibições estão habilitadas ou desabilitadas. Se o bit i, a partir do bit menos significativo, estiver definido, a instância de exibição i estará habilitada.
Valor retornado
Tipo: void Nenhum.Comentários
A máscara de instância de exibição afeta apenas PSOs que declaram o mascaramento de instância de exibição especificando o sinalizador D3D12_VIEW_INSTANCING_FLAG_ENABLE_VIEW_INSTANCE_MASKING durante sua criação. A tentativa de criar um PSO que declara o mascaramento de instância de exibição falhará em adaptadores que não dão suporte à instanciação de exibição. O valor padrão da máscara de instância de exibição é 0, o que desabilita todas as exibições. Isso força os aplicativos que declaram o mascaramento de instância de exibição a escolher explicitamente as exibições a serem habilitadas; caso contrário, nada será renderizado. Se a máscara de instância de exibição habilitasse todas as exibições por padrão, o aplicativo poderia não se lembrar de desabilitar as exibições não utilizadas, resultando em perda de desempenho devido a trabalho desperdiçado. Os pacotes não herdam a máscara de instância de exibição do chamador; em vez disso, o padrão é 0. Isso ocorre porque a configuração da máscara deve ser conhecida quando o pacote é gravado, caso afete a forma como uma implementação grava os desenhos. No entanto, a máscara de instância de exibição definida por um pacote persiste para o chamador após a conclusão do pacote. Essa semântica de herança é semelhante à dos PSOs. Nenhum caminho de código de shader que dependa de SV_ViewID é executado em qualquer estágio de shader para instâncias de exibição mascaradas, e nenhum recorte, processamento de visor ou rasterização é realizado. Implementações que inspecionam a máscara durante a renderização podem sofrer uma pequena penalidade de desempenho em comparação com PSOs que não declaram nenhum mascaramento de instância de exibição, mas geralmente essa penalidade pode ser compensada pela economia de desempenho resultante de ignorar o trabalho associado às exibições mascaradas. Dependendo da frequência e da quantidade de trabalho ignorado, os ganhos de desempenho podem ser significativos.Requisitos
Cabeçalho: d3d12_xs.h ou d3d12_x.hBiblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One