Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

Header

D3D10.h

See also

Resource Structures

 

 

Show:
© 2017 Microsoft