CD3D11_TEXTURE2D_DESC::CD3D11_TEXTURE2D_DESC(DXGI_FORMAT,UINT,UINT,UINT,UINT,UINT,D3D11_USAGE,UINT,UINT,UINT,UINT) function (d3d11.h)
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
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for