D3D10_TEXTURE2D_DESC structure

Describes a 2D texture.

Syntax

typedef struct D3D10_TEXTURE2D_DESC {
  UINT             Width;
  UINT             Height;
  UINT             MipLevels;
  UINT             ArraySize;
  DXGI_FORMAT      Format;
  DXGI_SAMPLE_DESC SampleDesc;
  D3D10_USAGE      Usage;
  UINT             BindFlags;
  UINT             CPUAccessFlags;
  UINT             MiscFlags;
} D3D10_TEXTURE2D_DESC;

Members

Width

Type: UINT

Texture width (in texels). The range is from 1 to D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192). For a texture cube-map, the range is from 1 to D3D10_REQ_TEXTURECUBE_DIMENSION (8192). For more information about restrictions, see Remarks.

Height

Type: UINT

Texture height (in texels). The range is from 1 to D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192). For a texture cube-map, the range is from 1 to D3D10_REQ_TEXTURECUBE_DIMENSION (8192). For more information about restrictions, see Remarks.

MipLevels

Type: UINT

Number of subtextures (also called mipmap levels). Use 1 for a multisampled texture; or 0 to generate a full set of subtextures.

ArraySize

Type: UINT

Number of textures in the texture array. The range is from 1 to D3D10_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (512). For a texture cube-map, this value is a multiple of 6 (that is, 6 * the value in the NumCubes member of D3D10_TEXCUBE_ARRAY_SRV1), and the range is from 6 to D3D10_REQ_TEXTURECUBE_DIMENSION.

Format

Type: DXGI_FORMAT

Texture format (see DXGI_FORMAT).

SampleDesc

Type: DXGI_SAMPLE_DESC

Structure that specifies multisampling parameters for the texture. See DXGI_SAMPLE_DESC.

Usage

Type: D3D10_USAGE

Value that identifies how the texture is to be read from and written to. The most common value is D3D10_USAGE-DEFAULT; see D3D10_USAGE for all possible values.

BindFlags

Type: UINT

Flags (see D3D10_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR.

CPUAccessFlags

Type: UINT

Flags (see D3D10_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR.

MiscFlags

Type: UINT

Flags (see D3D10_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. For a texture cube-map, set the D3D10_RESOURCE_MISC_TEXTURECUBE flag. Cube-map arrays (that is, ArraySize > 6) require feature level D3D_FEATURE_LEVEL_10_1.

Remarks

This structure is used in a call to ID3D10Device::CreateTexture2D. A helpful derived structure CD3D10_TEXTURE2D_DESC is declared in D3D10.h, to help create a texture description.

The device places some size restrictions (must be multiples of a minimum size) for a subsampled, block compressed, or bit-format resource.

Requirements

See also

Resource Structures