D3D10_1DDIARG_CREATESHADERRESOURCEVIEW Struktur (d3d10umddi.h)

Artikel
02/06/2025

Die D3D10_1DDIARG_CREATESHADERRESOURCEVIEW Struktur beschreibt die zu erstellende Shaderressourcenansicht.

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;

Angehörige

[in] hDrvResource

Ein Handle für die Shaderressource.

[in] Format

Ein DXGI_FORMAT typisierter Wert, der das Pixelformat der Ansicht angibt.

[in] ResourceDimension

Ein D3D10DDIRESOURCE_TYPE-typed-Wert, der den Ressourcentyp und die Dimensionalität angibt.

[in] Buffer

Wenn der Wert im ResourceDimension Member auf D3D10DDIRESOURCE_BUFFER festgelegt ist, wird ein Mitglied in der Union, das in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW enthalten ist, die eine D3D10DDIARG_BUFFER_SHADERRESOURCEVIEW Struktur für einen Puffer enthalten kann.

[in] Tex1D

Wenn der Wert im ResourceDimension Member auf D3D10DDIRESOURCE_TEXTURE1D festgelegt ist, wird ein Element in der Union, das in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW enthalten ist, die eine D3D10DDIARG_TEX1D_SHADERRESOURCEVIEW Struktur für eine eindimensionale Textur enthalten kann.

[in] Tex2D

Wenn der Wert im ResourceDimension Member auf D3D10DDIRESOURCE_TEXTURE2D festgelegt ist, wird ein Element in der Union, das in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW enthalten ist, die eine D3D10DDIARG_TEX2D_SHADERRESOURCEVIEW Struktur für eine zweidimensionale Textur enthalten kann.

[in] Tex3D

Wenn der Wert im ResourceDimension Member auf D3D10DDIRESOURCE_TEXTURE3D festgelegt ist, wird ein Element in der Union, das in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW enthalten ist, die eine D3D10DDIARG_TEX3D_SHADERRESOURCEVIEW Struktur für eine dreidimensionale Textur enthalten kann.

[in] TexCube

Wenn der Wert im ResourceDimension Member auf D3D10DDIRESOURCE_TEXTURECUBE festgelegt ist, wird ein Element in der Union, das in D3D10_1DDIARG_CREATESHADERRESOURCEVIEW enthalten ist, die eine D3D10DDIARG_TEXCUBE_SHADERRESOURCEVIEW Struktur für eine Cubetextur enthalten kann.

Bemerkungen

CreateShaderResourceView(D3D10_1) weist einen wesentlichen Funktionsunterschied zur Direct3D 10.0-Version auf (d. h.CreateShaderResourceView) im Hinblick auf das ResourceDimension Member von D3D10_1DDIARG_CREATESHADERRESOURCEVIEW. Wenn die Direct3D-Laufzeit versucht, eine Ansicht für eine Shaderressource zu erstellen, erfordert CreateShaderResourceView-, dass das ResourceDimension-Element Member von D3D10DDIARG_CREATESHADERRESOURCEVIEW mit dem ResourceDimension Member von D3D10DDIARG_CREATERESOURCE für die Shaderressource übereinstimmt, die in einem Aufruf der CreateResource(D3D10)-Funktion des Treibers erstellt wurde. Wenn die Direct3D 10.1-Laufzeit versucht, eine Ansicht für eine Shaderressource zu erstellen, ermöglicht CreateShaderResourceView(D3D10_1) eine leichte Entspannung für das ResourceDimension Member. CreateShaderResourceView(D3D10_1) ermöglicht die Erstellung von Tex2D-Ansichten auf TexCube-Ressourcen. Darüber hinaus ist die Unterscheidung zwischen TexCube auf Ressourcenebene in Direct3D Version 10.1 nicht mehr vorhanden. CreateShaderResourceView(D3D10_1) nur an, ob eine TexCube-Ansicht erstellt werden kann. In Direct3D Version 10.0 enthielten das Kopieren einer Ressource, die Überprüfung eines mehrfachen Renderziels usw. (d. h. verschiedene Vorgänge, für die der Ressourcentyp identisch sein musste) alle die Unterscheidung von TexCube, um in den Ressourcentyp einzuteilen. In Direct3D, Version 10.1, kann die Laufzeit nur Tex2D bestimmen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista Service Pack 1 (SP1)
mindestens unterstützte Server-	Windows Server 2008
Header-	d3d10umddi.h (include D3d10umddi.h)