structure D3D11_TEXTURE3D_DESC1 (d3d11_3.h)

Décrit une texture 3D.

Syntaxe

typedef struct D3D11_TEXTURE3D_DESC1 {
  UINT                 Width;
  UINT                 Height;
  UINT                 Depth;
  UINT                 MipLevels;
  DXGI_FORMAT          Format;
  D3D11_USAGE          Usage;
  UINT                 BindFlags;
  UINT                 CPUAccessFlags;
  UINT                 MiscFlags;
  D3D11_TEXTURE_LAYOUT TextureLayout;
} D3D11_TEXTURE3D_DESC1;

Membres

Width

Largeur de texture (en texels). La plage est comprise entre 1 et D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). Toutefois, la plage est en fait limitée par le niveau de fonctionnalité auquel vous créez l’appareil de rendu. Pour plus d’informations sur les restrictions, consultez Remarques.

Height

Hauteur de texture (en texels). La plage est comprise entre 1 et D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). Toutefois, la plage est en fait limitée par le niveau de fonctionnalité auquel vous créez l’appareil de rendu. Pour plus d’informations sur les restrictions, consultez Remarques.

Depth

Profondeur de texture (en texels). La plage est comprise entre 1 et D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). Toutefois, la plage est en fait limitée par le niveau de fonctionnalité auquel vous créez l’appareil de rendu. Pour plus d’informations sur les restrictions, consultez Remarques.

MipLevels

Nombre maximal de niveaux de mipmap dans la texture. Voir les remarques dans D3D11_TEX1D_SRV. Utilisez 1 pour une texture multi-échantillonnée ; ou 0 pour générer un ensemble complet de sous-textes.

Format

Format de texture (voir DXGI_FORMAT).

Usage

Valeur qui identifie le mode de lecture et d’écriture de la texture. La valeur la plus courante est D3D11_USAGE_DEFAULT ; consultez D3D11_USAGE pour connaître toutes les valeurs possibles.

BindFlags

Indicateurs (voir D3D11_BIND_FLAG) pour la liaison aux étapes de pipeline. Les indicateurs peuvent être combinés par un OR au niveau du bit.

CPUAccessFlags

Indicateurs (voir D3D11_CPU_ACCESS_FLAG) pour spécifier les types d’accès au processeur autorisés. Utilisez 0 si l’accès au processeur n’est pas requis. Ces indicateurs peuvent être combinés avec un OR au niveau du bit.

MiscFlags

Indicateurs (voir D3D11_RESOURCE_MISC_FLAG) qui identifient d’autres options de ressources moins courantes. Utilisez 0 si aucun de ces indicateurs ne s’applique. Ces indicateurs peuvent être combinés avec un OR au niveau du bit.

TextureLayout

Valeur de type D3D11_TEXTURE_LAYOUT qui identifie la disposition de la texture.

Le paramètre TextureLayout sélectionne à la fois la disposition réelle de la texture en mémoire et la disposition visible par l’application pendant que la texture est mappée. Ces indicateurs ne peuvent pas être demandés sans l’accès au processeur également demandé.

Il n’est pas autorisé à définir des indicateurs d’accès au processeur sur les textures par défaut sans définir également Disposition sur une valeur autre que D3D11_TEXTURE_LAYOUT_UNDEFINED.

D3D11_TEXTURE_LAYOUT_ROW_MAJOR ne peuvent pas être utilisés avec des textures 3D. D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE ne peuvent pas être utilisés avec des textures 3D qui ont des mipmaps.

Remarques

Cette structure est utilisée dans un appel à ID3D11Device3 ::CreateTexture3D1.

En plus de cette structure, vous pouvez également utiliser la CD3D11_TEXTURE3D_DESC1 structure dérivée, qui est définie dans D3D11_3.h et se comporte comme une classe héritée, pour vous aider à créer une description de texture.

L’appareil limite la taille des ressources au format sous-échantillonné, compressé par blocs et au format bit pour qu’elles soient multiples de tailles spécifiques à chaque format.

La plage de tailles de texture est déterminée par le niveau de fonctionnalité auquel vous créez l’appareil et non par la version de l’interface Microsoft Direct3D. Par exemple, si vous utilisez du matériel Microsoft Direct3D 10 au niveau de fonctionnalité 10 (D3D_FEATURE_LEVEL_10_0) et que vous appelez D3D11CreateDevice pour créer un ID3D11Device, vous devez limiter la taille de texture maximale à D3D10_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048) lorsque vous créez votre texture 3D.

Configuration requise

Condition requise Valeur
En-tête d3d11_3.h

Voir aussi

Structures de ressources