D3D10_1DDIARG_CREATESHADERRESOURCEVIEW structure

The D3D10_1DDIARG_CREATESHADERRESOURCEVIEW structure describes the shader resource view to create.

Syntax


typedef struct D3D10_1DDIARG_CREATESHADERRESOURCEVIEW {
  D3D10DDI_HRESOURCE    hDrvResource;
  DXGI_FORMAT           Format;
  D3D10DDIRESOURCE_TYPE ResourceDimension;
  union {
    D3D10DDIARG_BUFFER_SHADERRESOURCEVIEW    Buffer;
    D3D10DDIARG_TEX1D_SHADERRESOURCEVIEW     Tex1D;
    D3D10DDIARG_TEX2D_SHADERRESOURCEVIEW     Tex2D;
    D3D10DDIARG_TEX3D_SHADERRESOURCEVIEW     Tex3D;
    D3D10_1DDIARG_TEXCUBE_SHADERRESOURCEVIEW TexCube;
  };
} D3D10_1DDIARG_CREATESHADERRESOURCEVIEW;

Members

hDrvResource

[in] A handle to the shader resource.

Format

[in] A DXGI_FORMAT-typed value that indicates the pixel format of the view.

ResourceDimension

[in] A D3D10DDIRESOURCE_TYPE-typed value that indicates the resource type and dimensionality.

Buffer

[in] If the value in the ResourceDimension member is set to D3D10DDIRESOURCE_BUFFER, a member in the union that is contained in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW that can hold a D3D10DDIARG_BUFFER_SHADERRESOURCEVIEW structure for a buffer.

Tex1D

[in] If the value in the ResourceDimension member is set to D3D10DDIRESOURCE_TEXTURE1D, a member in the union that is contained in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW that can hold a D3D10DDIARG_TEX1D_SHADERRESOURCEVIEW structure for a one-dimensional texture.

Tex2D

[in] If the value in the ResourceDimension member is set to D3D10DDIRESOURCE_TEXTURE2D, a member in the union that is contained in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW that can hold a D3D10DDIARG_TEX2D_SHADERRESOURCEVIEW structure for a two-dimensional texture.

Tex3D

[in] If the value in the ResourceDimension member is set to D3D10DDIRESOURCE_TEXTURE3D, a member in the union that is contained in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW that can hold a D3D10DDIARG_TEX3D_SHADERRESOURCEVIEW structure for a three-dimensional texture.

TexCube

[in] If the value in the ResourceDimension member is set to D3D10DDIRESOURCE_TEXTURECUBE, a member in the union that is contained in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW that can hold a D3D10_1DDIARG_TEXCUBE_SHADERRESOURCEVIEW structure for a cube texture.

Remarks

CreateShaderResourceView(D3D10_1) has a major functionality difference from the Direct3D 10.0 version (that is,CreateShaderResourceView) in regard to the ResourceDimension member of D3D10_1DDIARG_CREATESHADERRESOURCEVIEW. If the Direct3D runtime attempts to create a view on a shader resource, CreateShaderResourceView requires that the ResourceDimension member of D3D10DDIARG_CREATESHADERRESOURCEVIEW match the ResourceDimension member of D3D10DDIARG_CREATERESOURCE for the shader resource that was created in a call to the driver's CreateResource(D3D10) function. If the Direct3D 10.1 runtime attempts to create a view on a shader resource, CreateShaderResourceView(D3D10_1) allows a slight relaxation for its ResourceDimension member. CreateShaderResourceView(D3D10_1) allows the creation of Tex2D views on TexCube resources. In addition, the distinction between TexCube at the resource level is gone in Direct3D version 10.1. CreateShaderResourceView(D3D10_1) only represents whether it can create a TexCube view. In Direct3D version 10.0, copying a resource, validation of a multiple render target, and so on (that is, various operations that required the resource type to be identical) all included the distinction of TexCube to factor into the resource type. In Direct3D version 10.1, the runtime can determine only Tex2D.

Requirements

Version

D3D10_1DDIARG_CREATESHADERRESOURCEVIEW is supported on Windows Vista with Service Pack 1 (SP1) and later versions and Windows Server 2008 and later versions.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateShaderResourceViewSize(D3D10_1)
CreateShaderResourceView(D3D10_1)
D3D10_1DDIARG_TEXCUBE_SHADERRESOURCEVIEW
D3D10DDIARG_BUFFER_SHADERRESOURCEVIEW
D3D10DDIARG_TEX1D_SHADERRESOURCEVIEW
D3D10DDIARG_TEX2D_SHADERRESOURCEVIEW
D3D10DDIARG_TEX3D_SHADERRESOURCEVIEW
D3D10DDIRESOURCE_TYPE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft