Share via


CD3D11_TEXTURE2D_DESC::CD3D11_TEXTURE2D_DESC(DXGI_FORMAT,UINT,UINT,UINT,UINT,UINT,UINT,D3D11_USAGE,UINT,UINT,UINT)-Funktion (d3d11.h)

Instanziiert eine neue instance einer CD3D11_TEXTURE2D_DESC-Struktur, die mit D3D11_TEXTURE2D_DESC Werten initialisiert wird.

Syntax

void CD3D11_TEXTURE2D_DESC(
  DXGI_FORMAT format,
  UINT        width,
  UINT        height,
  UINT        arraySize,
  UINT        mipLevels,
  UINT        bindFlags,
  D3D11_USAGE usage,
  UINT        cpuaccessFlags,
  UINT        sampleCount,
  UINT        sampleQuality,
  UINT        miscFlags
);

Parameter

format

Typ: DXGI_FORMAT

Ein DXGI_FORMAT typisierter Wert, der das Texturformat angibt.

width

Typ: UINT

Texturbreite (in Texels). Der Bereich reicht von 1 bis D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Bei einer Texturwürfelzuordnung liegt der Bereich zwischen 1 und D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Der Bereich wird jedoch tatsächlich durch die Featureebene eingeschränkt, auf der Sie das Renderinggerät erstellen.

height

Typ: UINT

Texturhöhe (in Texels). Der Bereich reicht von 1 bis D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Bei einer Texturwürfelzuordnung liegt der Bereich zwischen 1 und D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Der Bereich wird jedoch tatsächlich durch die Featureebene eingeschränkt, auf der Sie das Renderinggerät erstellen.

arraySize

Typ: UINT

Anzahl der Texturen im Texturarray. Der Bereich reicht von 1 bis D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). Für eine Texturwürfelzuordnung ist dieser Wert ein Vielfaches von 6 (d. h. das 6-fache des Werts im NumCubes-Member von D3D11_TEXCUBE_ARRAY_SRV), und der Bereich liegt zwischen 6 und 2046. Der Bereich ist tatsächlich durch die Featureebene eingeschränkt, auf der Sie das Renderinggerät erstellen.

mipLevels

Typ: UINT

Die maximale Anzahl von Mipmap-Ebenen in der Textur. Siehe die Hinweise in D3D11_TEX1D_SRV. Verwenden Sie 1 für eine mehrstufige Textur. oder 0, um einen vollständigen Satz von Untertexturen zu generieren.

bindFlags

Typ: UINT

Eine Kombination aus D3D11_BIND_FLAG typisierten Werten, die mithilfe eines bitweisen OR-Vorgangs kombiniert werden. Der resultierende Wert gibt an, wie die Textur an Pipelinephasen gebunden werden soll.

usage

Typ: D3D11_USAGE

Ein D3D11_USAGE typisierter Wert, der angibt, wie die Textur gelesen und in diese geschrieben werden soll.

cpuaccessFlags

Typ: UINT

Eine Kombination aus D3D11_CPU_ACCESS_FLAG typisierten Werten, die mithilfe eines bitweisen OR-Vorgangs kombiniert werden. Der resultierende Wert gibt die Typen des zulässigen CPU-Zugriffs an.

sampleCount

Typ: UINT

Die Stichprobenanzahl.

sampleQuality

Typ: UINT

Die Beispielqualität.

miscFlags

Typ: UINT

Eine Kombination aus D3D11_RESOURCE_MISC_FLAG typisierten Werten, die mithilfe eines bitweisen OR-Vorgangs kombiniert werden. Der resultierende Wert identifiziert andere, weniger häufige Ressourcenoptionen. Legen Sie für eine Texturwürfelzuordnung das D3D11_RESOURCE_MISC_TEXTURECUBE-Flag fest. Cubezuordnungsarrays (d. h. arraySize> 6) erfordern D3D_FEATURE_LEVEL_10_1 oder höher auf Featureebene.

Rückgabewert

Keine

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d3d11.h
Bibliothek D3D11.lib

Weitere Informationen

CD3D11_TEXTURE2D_DESC