Edit

CD3D11_TEXTURE2D_DESC::CD3D11_TEXTURE2D_DESC(DXGI_FORMAT,UINT,UINT,UINT,UINT,UINT,D3D11_USAGE,UINT,UINT,UINT,UINT) function (d3d11.h)

  • Article

Instantiates a new instance of a CD3D11_TEXTURE2D_DESC structure that is initialized with D3D11_TEXTURE2D_DESC values.

Syntax

void CD3D11_TEXTURE2D_DESC(
  DXGI_FORMAT format,
  UINT        width,
  UINT        height,
  UINT        arraySize,
  UINT        mipLevels,
  UINT        bindFlags,
  D3D11_USAGE usage,
  UINT        cpuaccessFlags,
  UINT        sampleCount,
  UINT        sampleQuality,
  UINT        miscFlags
);

Parameters

format

Type: DXGI_FORMAT

A DXGI_FORMAT-typed value that specifies the texture format.

width

Type: UINT

Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device.

height

Type: UINT

Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device.

arraySize

Type: UINT

Number of textures in the texture array. The range is from 1 to D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). For a texture cube-map, this value is a multiple of 6 (that is, 6 times the value in the NumCubes member of D3D11_TEXCUBE_ARRAY_SRV), and the range is from 6 to 2046. The range is actually constrained by the feature level at which you create the rendering device.

mipLevels

Type: UINT

The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures.

bindFlags

Type: UINT

A combination of D3D11_BIND_FLAG-typed values that are combined by using a bitwise OR operation. The resulting value specifies how to bind the texture to pipeline stages.

usage

Type: D3D11_USAGE

A D3D11_USAGE-typed value that identifies how the texture is to be read from and written to.

cpuaccessFlags

Type: UINT

A combination of D3D11_CPU_ACCESS_FLAG-typed values that are combined by using a bitwise OR operation. The resulting value specifies the types of CPU access allowed.

sampleCount

Type: UINT

The sample count.

sampleQuality

Type: UINT

The sample quality.

miscFlags

Type: UINT

A combination of D3D11_RESOURCE_MISC_FLAG-typed values that are combined by using a bitwise OR operation. The resulting value identifies other, less common resource options. For a texture cube-map, set the D3D11_RESOURCE_MISC_TEXTURECUBE flag. Cube-map arrays (that is, arraySize > 6) require feature level D3D_FEATURE_LEVEL_10_1 or higher.

Return value

None

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d3d11.h
Library D3D11.lib

See also

CD3D11_TEXTURE2D_DESC