Edit

D3D10_1DDIARG_CREATESHADERRESOURCEVIEW structure (d3d10umddi.h)

  • Article

The D3D10_1DDIARG_CREATESHADERRESOURCEVIEW structure describes the shader resource view to create.

Syntax

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

Members

[in] hDrvResource

A handle to the shader resource.

[in] Format

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

[in] ResourceDimension

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

[in] Buffer

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.

[in] Tex1D

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.

[in] Tex2D

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.

[in] Tex3D

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.

[in] TexCube

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 D3D10DDIARG_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

Requirement Value
Minimum supported client Windows Vista Service Pack 1 (SP1)
Minimum supported server Windows Server 2008
Header d3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateShaderResourceViewSize(D3D10_1)

CreateShaderResourceView(D3D10_1)

D3D10DDIARG_BUFFER_SHADERRESOURCEVIEW

D3D10DDIARG_TEX1D_SHADERRESOURCEVIEW

D3D10DDIARG_TEX2D_SHADERRESOURCEVIEW

D3D10DDIARG_TEX3D_SHADERRESOURCEVIEW

D3D10DDIARG_TEXCUBE_SHADERRESOURCEVIEW

D3D10DDIRESOURCE_TYPE