structure D3D12_DEPTH_STENCIL_VIEW_DESC (d3d12.h)

Article
02/28/2024

Décrit les sous-ressources d’une texture qui sont accessibles à partir d’une vue de gabarit en profondeur.

Syntaxe

typedef struct D3D12_DEPTH_STENCIL_VIEW_DESC {
  DXGI_FORMAT         Format;
  D3D12_DSV_DIMENSION ViewDimension;
  D3D12_DSV_FLAGS     Flags;
  union {
    D3D12_TEX1D_DSV         Texture1D;
    D3D12_TEX1D_ARRAY_DSV   Texture1DArray;
    D3D12_TEX2D_DSV         Texture2D;
    D3D12_TEX2D_ARRAY_DSV   Texture2DArray;
    D3D12_TEX2DMS_DSV       Texture2DMS;
    D3D12_TEX2DMS_ARRAY_DSV Texture2DMSArray;
  };
} D3D12_DEPTH_STENCIL_VIEW_DESC;

Membres

Format

Valeur de type DXGI_FORMAT qui spécifie le format d’affichage. Pour connaître les formats autorisés, consultez Remarques.

ViewDimension

Valeur de type D3D12_DSV_DIMENSION qui spécifie le mode d’accès à la ressource de gabarit de profondeur. Ce membre détermine également les _DSV à utiliser dans l’union suivante.

Flags

Combinaison de D3D12_DSV_FLAGS constantes d’énumération combinées à l’aide d’une opération OR au niveau du bit. La valeur résultante spécifie si la texture est en lecture seule.
Passez 0 pour spécifier qu’il n’est pas en lecture seule ; sinon, transmettez un ou plusieurs des membres du D3D12_DSV_FLAGS type énuméré.

Texture1D

Structure D3D12_TEX1D_DSV qui spécifie une sous-source de texture 1D.

Texture1DArray

Structure D3D12_TEX1D_ARRAY_DSV qui spécifie un tableau de sous-ressources de texture 1D.

Texture2D

Structure D3D12_TEX2D_DSV qui spécifie une sous-ressource de texture 2D.

Texture2DArray

Une structure D3D12_TEX2D_ARRAY_DSV qui spécifie un tableau de sous-ressources de texture 2D.

Texture2DMS

Structure D3D12_TEX2DMS_DSV qui spécifie une texture 2D multi-échantillonnée.

Texture2DMSArray

Structure D3D12_TEX2DMS_ARRAY_DSV qui spécifie un tableau de textures 2D multi-échantillonnée.

Remarques

Il s’agit des formats valides pour une vue de gabarit de profondeur :

DXGI_FORMAT_D16_UNORM
DXGI_FORMAT_D24_UNORM_S8_UINT
DXGI_FORMAT_D32_FLOAT
DXGI_FORMAT_D32_FLOAT_S8X24_UINT
DXGI_FORMAT_UNKNOWN

Une vue de gabarit de profondeur ne peut pas utiliser un format sans type. Si le format choisi est DXGI_FORMAT_UNKNOWN, le format de la ressource parente est utilisé.

Passez une description de profondeur-gabarit-vue dans ID3D12Device ::CreateDepthStencilView pour créer une vue de gabarit de profondeur.

Configuration requise

Condition requise	Valeur
En-tête	d3d12.h

Voir aussi

Structures principales

Partager via