structure D3D10_1DDIARG_CREATESHADERRESOURCEVIEW (d3d10umddi.h)

Article
02/06/2025

La structure D3D10_1DDIARG_CREATESHADERRESOURCEVIEW décrit la vue des ressources du nuanceur à créer.

Syntaxe

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;

Membres

[in] hDrvResource

Handle de la ressource de nuanceur.

[in] Format

Valeur DXGI_FORMAT typée qui indique le format de pixel de la vue.

[in] ResourceDimension

Valeur D3D10DDIRESOURCE_TYPE-typée qui indique le type de ressource et la dimensionnalité.

[in] Buffer

Si la valeur du membre ResourceDimension est définie sur D3D10DDIRESOURCE_BUFFER, un membre de l’union contenu dans D3D10_1DDIARG_CREATESHADERRESOURCEVIEW qui peut contenir une structure de D3D10DDIARG_BUFFER_SHADERRESOURCEVIEW pour une mémoire tampon.

[in] Tex1D

Si la valeur du membre ResourceDimension est définie sur D3D10DDIRESOURCE_TEXTURE1D, un membre de l’union contenu dans D3D10_1DDIARG_CREATESHADERRESOURCEVIEW pouvant contenir une structure D3D10DDIARG_TEX1D_SHADERRESOURCEVIEW pour une texture unidimensionnelle.

[in] Tex2D

Si la valeur du membre ResourceDimension est définie sur D3D10DDIRESOURCE_TEXTURE2D, un membre de l’union contenu dans D3D10_1DDIARG_CREATESHADERRESOURCEVIEW pouvant contenir une structure D3D10DDIARG_TEX2D_SHADERRESOURCEVIEW pour une texture à deux dimensions.

[in] Tex3D

Si la valeur du membre ResourceDimension est définie sur D3D10DDIRESOURCE_TEXTURE3D, un membre de l’union contenu dans D3D10_1DDIARG_CREATESHADERRESOURCEVIEW pouvant contenir une structure D3D10DDIARG_TEX3D_SHADERRESOURCEVIEW pour une texture tridimensionnelle.

[in] TexCube

Si la valeur du membre ResourceDimension est définie sur D3D10DDIRESOURCE_TEXTURECUBE, un membre de l’union contenu dans D3D10_1DDIARG_CREATESHADERRESOURCEVIEW qui peut contenir une structure D3D10DDIARG_TEXCUBE_SHADERRESOURCEVIEW pour une texture de cube.

Remarques

CreateShaderResourceView(D3D10_1) présente une différence de fonctionnalité majeure par rapport à la version Direct3D 10.0 (autrement dit,CreateShaderResourceView) en ce qui concerne le membre ResourceDimension de D3D10_1DDIARG_CREATESHADERRESOURCEVIEW. Si le runtime Direct3D tente de créer une vue sur une ressource de nuanceur, CreateShaderResourceView exige que le membre ResourceDimension de D3D10DDIARG_CREATESHADERRESOURCEVIEW corresponde au membre ResourceDimension de D3D10DDIARG_CREATERESOURCE pour la ressource de nuanceur créée dans un appel à la fonction CreateResource(D3D10) du pilote. Si le runtime Direct3D 10.1 tente de créer une vue sur une ressource de nuanceur, CreateShaderResourceView(D3D10_1) permet une légère détente pour son membre ResourceDimension . createShaderResourceView(D3D10_1) permet de créer des vues Tex2D sur des ressources TexCube. En outre, la distinction entre TexCube au niveau de la ressource est passée dans Direct3D version 10.1. CreateShaderResourceView(D3D10_1) indique uniquement s’il peut créer une vue TexCube. Dans Direct3D version 10.0, la copie d’une ressource, la validation d’une cible de rendu multiple, et ainsi de suite (c’est-à-dire les différentes opérations qui ont exigé que le type de ressource soit identique) incluaient toutes la distinction entre TexCube et le type de ressource. Dans Direct3D version 10.1, le runtime peut déterminer uniquement Tex2D.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista Service Pack 1 (SP1)
serveur minimum pris en charge	Windows Server 2008
d’en-tête	d3d10umddi.h (include D3d10umddi.h)