structure D3D10_1DDIARG_CREATESHADERRESOURCEVIEW (d3d10umddi.h)

Article
02/22/2024

La structure D3D10_1DDIARG_CREATESHADERRESOURCEVIEW décrit l’affichage 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 de type DXGI_FORMAT qui indique le format de pixels de la vue.

[in] ResourceDimension

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

[in] Buffer

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

[in] Tex1D

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

[in] Tex2D

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

[in] Tex3D

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

[in] TexCube

Si la valeur dans le 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 10.0 de Direct3D (c’est-à-dire 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 qui a été 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 relaxation 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 des ressources a disparu 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, etc. (c’est-à-dire diverses opérations qui exigeaient que le type de ressource soit identique) incluaient toutes la distinction de TexCube à prendre en compte dans le type de ressource. Dans Direct3D version 10.1, le runtime peut déterminer uniquement Tex2D.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista Service Pack 1 (SP1)
Serveur minimal pris en charge	Windows Server 2008
En-tête	d3d10umddi.h (include D3d10umddi.h)