CD3D11_SHADER_RESOURCE_VIEW_DESC class

Represents a shader-resource view and provides convenience methods for creating shader-resource views.

Members

The CD3D11_SHADER_RESOURCE_VIEW_DESC class inherits from D3D11_SHADER_RESOURCE_VIEW_DESC. CD3D11_SHADER_RESOURCE_VIEW_DESC also has these types of members:

Constructors
Methods

Constructors

The CD3D11_SHADER_RESOURCE_VIEW_DESC class has these constructors.

Constructor	Description
CD3D11_SHADER_RESOURCE_VIEW_DESC()	Instantiates a new instance of an uninitialized CD3D11_SHADER_RESOURCE_VIEW_DESC structure.
CD3D11_SHADER_RESOURCE_VIEW_DESC(D3D11_SHADER_RESOURCE_VIEW_DESC_values1)(D3D11_SRV_DIMENSION,DXGI_FORMAT,UINT,UINT,UINT,UINT,UINT)	Instantiates a new instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure that is initialized with D3D11_SHADER_RESOURCE_VIEW_DESC values.
CD3D11_SHADER_RESOURCE_VIEW_DESC(D3D11_SHADER_RESOURCE_VIEW_DESC_values2)(ID3D11Buffer,DXGI_FORMAT,UINT,UINT,UINT)	Instantiates a new instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure that is initialized with D3D11_BUFFEREX_SRV values.
CD3D11_SHADER_RESOURCE_VIEW_DESC(D3D11_SHADER_RESOURCE_VIEW_DESC_values3)(ID3D11Texture1D,D3D11_SRV_DIMENSION,DXGI_FORMAT,UINT,UINT,UINT,UINT)	Instantiates a new instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure that is initialized with D3D11_TEX1D_SRV or D3D11_TEX1D_ARRAY_SRV values.
CD3D11_SHADER_RESOURCE_VIEW_DESC(D3D11_SHADER_RESOURCE_VIEW_DESC_values4)(ID3D11Texture2D,D3D11_SRV_DIMENSION,DXGI_FORMAT,UINT,UINT,UINT,UINT)	Instantiates a new instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure that is initialized with 2D texture values.
CD3D11_SHADER_RESOURCE_VIEW_DESC(D3D11_SHADER_RESOURCE_VIEW_DESC_values5)(ID3D11Texture3D,DXGI_FORMAT,UINT,UINT)	Instantiates a new instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure that is initialized with 3D texture values.

Methods

The CD3D11_SHADER_RESOURCE_VIEW_DESC class has these methods.

Method	Description
~CD3D11_SHADER_RESOURCE_VIEW_DESC()	Destroys an instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure.
CD3D11_SHADER_RESOURCE_VIEW_DESC(D3D11_SHADER_RESOURCE_VIEW_DESC)(const &D3D11_SHADER_RESOURCE_VIEW_DESC)	Instantiates a new instance of a CD3D11_SHADER_RESOURCE_VIEW_DESC structure that is initialized with a D3D11_SHADER_RESOURCE_VIEW_DESC structure.
D3D11_SHADER_RESOURCE_VIEW_DESC()	This operator returns the address of a D3D11_SHADER_RESOURCE_VIEW_DESC structure that contains the data from the CD3D11_SHADER_RESOURCE_VIEW_DESC instance.

Remarks

Here is how D3D11.h defines CD3D11_SHADER_RESOURCE_VIEW_DESC:


struct CD3D11_SHADER_RESOURCE_VIEW_DESC : public D3D11_SHADER_RESOURCE_VIEW_DESC
{
 CD3D11_SHADER_RESOURCE_VIEW_DESC()
 {}
 explicit CD3D11_SHADER_RESOURCE_VIEW_DESC( const D3D11_SHADER_RESOURCE_VIEW_DESC& o ) :
 D3D11_SHADER_RESOURCE_VIEW_DESC( o )
 {}
 explicit CD3D11_SHADER_RESOURCE_VIEW_DESC(
 D3D11_SRV_DIMENSION viewDimension,
 DXGI_FORMAT format = DXGI_FORMAT_UNKNOWN,
 UINT mostDetailedMip = 0, // FirstElement for BUFFER
 UINT mipLevels = -1, // NumElements for BUFFER
 UINT firstArraySlice = 0, // First2DArrayFace for TEXTURECUBEARRAY
 UINT arraySize = -1, // NumCubes for TEXTURECUBEARRAY
 UINT flags = 0 ) // BUFFEREX only
 {
 Format = format;
 ViewDimension = viewDimension;
 switch (viewDimension)
 {
 case D3D11_SRV_DIMENSION_BUFFER:
 Buffer.FirstElement = mostDetailedMip;
 Buffer.NumElements = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE1D:
 Texture1D.MostDetailedMip = mostDetailedMip;
 Texture1D.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE1DARRAY:
 Texture1DArray.MostDetailedMip = mostDetailedMip;
 Texture1DArray.MipLevels = mipLevels;
 Texture1DArray.FirstArraySlice = firstArraySlice;
 Texture1DArray.ArraySize = arraySize;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2D:
 Texture2D.MostDetailedMip = mostDetailedMip;
 Texture2D.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2DARRAY:
 Texture2DArray.MostDetailedMip = mostDetailedMip;
 Texture2DArray.MipLevels = mipLevels;
 Texture2DArray.FirstArraySlice = firstArraySlice;
 Texture2DArray.ArraySize = arraySize;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2DMS:
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2DMSARRAY:
 Texture2DMSArray.FirstArraySlice = firstArraySlice;
 Texture2DMSArray.ArraySize = arraySize;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE3D:
 Texture3D.MostDetailedMip = mostDetailedMip;
 Texture3D.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURECUBE:
 TextureCube.MostDetailedMip = mostDetailedMip;
 TextureCube.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURECUBEARRAY:
 TextureCubeArray.MostDetailedMip = mostDetailedMip;
 TextureCubeArray.MipLevels = mipLevels;
 TextureCubeArray.First2DArrayFace = firstArraySlice;
 TextureCubeArray.NumCubes = arraySize;
 break;
 case D3D11_SRV_DIMENSION_BUFFEREX:
 BufferEx.FirstElement = mostDetailedMip;
 BufferEx.NumElements = mipLevels;
 BufferEx.Flags = flags;
 break;
 default: break;
 }
 }
 explicit CD3D11_SHADER_RESOURCE_VIEW_DESC(
 _In_ ID3D11Buffer*,
 DXGI_FORMAT format,
 UINT firstElement,
 UINT numElements,
 UINT flags = 0 )
 {
 Format = format;
 ViewDimension = D3D11_SRV_DIMENSION_BUFFEREX;
 BufferEx.FirstElement = firstElement;
 BufferEx.NumElements = numElements;
 BufferEx.Flags = flags;
 }
 explicit CD3D11_SHADER_RESOURCE_VIEW_DESC(
 _In_ ID3D11Texture1D* pTex1D,
 D3D11_SRV_DIMENSION viewDimension,
 DXGI_FORMAT format = DXGI_FORMAT_UNKNOWN,
 UINT mostDetailedMip = 0,
 UINT mipLevels = -1,
 UINT firstArraySlice = 0,
 UINT arraySize = -1 )
 {
 ViewDimension = viewDimension;
 if (DXGI_FORMAT_UNKNOWN == format || -1 == mipLevels ||
 (-1 == arraySize && D3D11_SRV_DIMENSION_TEXTURE1DARRAY == viewDimension))
 {
 D3D11_TEXTURE1D_DESC TexDesc;
 pTex1D->GetDesc( &TexDesc );
 if (DXGI_FORMAT_UNKNOWN == format) format = TexDesc.Format;
 if (-1 == mipLevels) mipLevels = TexDesc.MipLevels - mostDetailedMip;
 if (-1 == arraySize) arraySize = TexDesc.ArraySize - firstArraySlice;
 }
 Format = format;
 switch (viewDimension)
 {
 case D3D11_SRV_DIMENSION_TEXTURE1D:
 Texture1D.MostDetailedMip = mostDetailedMip;
 Texture1D.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE1DARRAY:
 Texture1DArray.MostDetailedMip = mostDetailedMip;
 Texture1DArray.MipLevels = mipLevels;
 Texture1DArray.FirstArraySlice = firstArraySlice;
 Texture1DArray.ArraySize = arraySize;
 break;
 default: break;
 }
 }
 explicit CD3D11_SHADER_RESOURCE_VIEW_DESC(
 _In_ ID3D11Texture2D* pTex2D,
 D3D11_SRV_DIMENSION viewDimension,
 DXGI_FORMAT format = DXGI_FORMAT_UNKNOWN,
 UINT mostDetailedMip = 0,
 UINT mipLevels = -1,
 UINT firstArraySlice = 0, // First2DArrayFace for TEXTURECUBEARRAY
 UINT arraySize = -1 ) // NumCubes for TEXTURECUBEARRAY
 {
 ViewDimension = viewDimension;
 if (DXGI_FORMAT_UNKNOWN == format || 
 (-1 == mipLevels &&
 D3D11_SRV_DIMENSION_TEXTURE2DMS != viewDimension &&
 D3D11_SRV_DIMENSION_TEXTURE2DMSARRAY != viewDimension) ||
 (-1 == arraySize &&
 (D3D11_SRV_DIMENSION_TEXTURE2DARRAY == viewDimension ||
 D3D11_SRV_DIMENSION_TEXTURE2DMSARRAY == viewDimension ||
 D3D11_SRV_DIMENSION_TEXTURECUBEARRAY == viewDimension)))
 {
 D3D11_TEXTURE2D_DESC TexDesc;
 pTex2D->GetDesc( &TexDesc );
 if (DXGI_FORMAT_UNKNOWN == format) format = TexDesc.Format;
 if (-1 == mipLevels) mipLevels = TexDesc.MipLevels - mostDetailedMip;
 if (-1 == arraySize)
 {
 arraySize = TexDesc.ArraySize - firstArraySlice;
 if (D3D11_SRV_DIMENSION_TEXTURECUBEARRAY == viewDimension) arraySize /= 6;
 }
 }
 Format = format;
 switch (viewDimension)
 {
 case D3D11_SRV_DIMENSION_TEXTURE2D:
 Texture2D.MostDetailedMip = mostDetailedMip;
 Texture2D.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2DARRAY:
 Texture2DArray.MostDetailedMip = mostDetailedMip;
 Texture2DArray.MipLevels = mipLevels;
 Texture2DArray.FirstArraySlice = firstArraySlice;
 Texture2DArray.ArraySize = arraySize;
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2DMS:
 break;
 case D3D11_SRV_DIMENSION_TEXTURE2DMSARRAY:
 Texture2DMSArray.FirstArraySlice = firstArraySlice;
 Texture2DMSArray.ArraySize = arraySize;
 break;
 case D3D11_SRV_DIMENSION_TEXTURECUBE:
 TextureCube.MostDetailedMip = mostDetailedMip;
 TextureCube.MipLevels = mipLevels;
 break;
 case D3D11_SRV_DIMENSION_TEXTURECUBEARRAY:
 TextureCubeArray.MostDetailedMip = mostDetailedMip;
 TextureCubeArray.MipLevels = mipLevels;
 TextureCubeArray.First2DArrayFace = firstArraySlice;
 TextureCubeArray.NumCubes = arraySize;
 break;
 default: break;
 }
 }
 explicit CD3D11_SHADER_RESOURCE_VIEW_DESC(
 _In_ ID3D11Texture3D* pTex3D,
 DXGI_FORMAT format = DXGI_FORMAT_UNKNOWN,
 UINT mostDetailedMip = 0,
 UINT mipLevels = -1 )
 {
 ViewDimension = D3D11_SRV_DIMENSION_TEXTURE3D;
 if (DXGI_FORMAT_UNKNOWN == format || -1 == mipLevels)
 {
 D3D11_TEXTURE3D_DESC TexDesc;
 pTex3D->GetDesc( &TexDesc );
 if (DXGI_FORMAT_UNKNOWN == format) format = TexDesc.Format;
 if (-1 == mipLevels) mipLevels = TexDesc.MipLevels - mostDetailedMip;
 }
 Format = format;
 Texture3D.MostDetailedMip = mostDetailedMip;
 Texture3D.MipLevels = mipLevels;
 }
 ~CD3D11_SHADER_RESOURCE_VIEW_DESC() {}
 operator const D3D11_SHADER_RESOURCE_VIEW_DESC&() const { return *this; }
};

Requirements

Minimum supported client	Windows 7 [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 R2 [desktop apps \| UWP apps]
Header	D3D11.h
Library	D3D11.lib

Additional resources

Last updated on

URL: https://learn.microsoft.com/en-us/previous-versions/windows/desktop/legacy/jj151684(v=vs.85)

⇱ CD3D11_SHADER_RESOURCE_VIEW_DESC class (Windows) | Microsoft Learn