Método ID3D12GraphicsCommandList1::SetViewInstanceMask (d3d12.h)
Establezca una máscara que controla qué instancias de vista están habilitadas para los sorteos posteriores.
Sintaxis
void SetViewInstanceMask(
[in] UINT Mask
);
Parámetros
[in] Mask
Tipo: UINT
Máscara que especifica qué vistas están habilitadas o deshabilitadas. Si se establece el bit i a partir del bit menos significativo, se habilita la instancia de vista i .
Valor devuelto
None
Observaciones
La máscara de instancia de vista solo afecta a los SPO que declaran el enmascaramiento de instancias de vista especificando la marca de D3D12_VIEW_INSTANCING_FLAG_ENABLE_VIEW_INSTANCE_MASKING durante su creación. Se producirá un error al intentar crear una INSTRUCCIÓN PARA QUE declare el enmascaramiento de instancias de vista en los adaptadores que no admiten la creación de instancias de vista.
La máscara de instancia de vista tiene como valor predeterminado 0, lo que deshabilita todas las vistas. Esto obliga a las aplicaciones que declaran el enmascaramiento de instancias de vista para elegir explícitamente las vistas que se van a habilitar; de lo contrario, no se representará nada. Si la máscara de instancia de vista ha habilitado todas las vistas de forma predeterminada, es posible que la aplicación no recuerde deshabilitar las vistas sin usar, lo que da lugar a una pérdida de rendimiento debido al trabajo desperdiciado.
Los conjuntos no heredan su máscara de instancia de vista de su llamador, de forma predeterminada en 0. Esto se debe a que la configuración de máscara debe conocerse cuando se registra la agrupación si afecta a cómo dibuja un registro de implementación. Sin embargo, la máscara de instancia de vista establecida por un lote persiste en el autor de la llamada una vez completada la agrupación. Esta semántica de herencia es similar a la de los SPO.
Ninguna ruta de acceso de código de sombreador que dependa de SV_ViewID se ejecuta en cualquier fase del sombreador para las instancias de vista enmascaradas y no se realiza ningún recorte, procesamiento de ventanilla o rasterización. Las implementaciones que inspeccionan la máscara durante la representación pueden suponer una pequeña penalización de rendimiento sobre los SPO que no declaran el enmascaramiento de instancias de vista, pero normalmente la penalización puede superarse por el ahorro de rendimiento que resulta de omitir el trabajo asociado a las vistas enmascaradas. Dependiendo de la frecuencia y la cantidad de trabajo omitido, las ganancias de rendimiento pueden ser significativas.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d12.h |