ID3D11DeviceContext::ResolveSubresource-Methode (d3d11.h)

Artikel
08/22/2023

Kopieren Sie eine Ressource mit mehreren Stempeln in eine Ressource, die nicht mit mehreren Stempeln ist.

Syntax

void ResolveSubresource(
  [in] ID3D11Resource *pDstResource,
  [in] UINT           DstSubresource,
  [in] ID3D11Resource *pSrcResource,
  [in] UINT           SrcSubresource,
  [in] DXGI_FORMAT    Format
);

Parameter

[in] pDstResource

Typ: ID3D11Resource*

Zielressource. Muss ein mit dem D3D11_USAGE_DEFAULT-Flag erstellt und mit einer einzelnen Stichprobe erstellt werden. Siehe ID3D11Resource.

[in] DstSubresource

Typ: UINT

Ein nullbasierter Index, der die Zielunterressource identifiziert. Verwenden Sie D3D11CalcSubresource , um den Index zu berechnen.

[in] pSrcResource

Typ: ID3D11Resource*

Quellressource. Muss multisampled sein.

[in] SrcSubresource

Typ: UINT

Die Quellunterressource der Quellressource.

[in] Format

Typ: DXGI_FORMAT

Ein DXGI_FORMAT , der angibt, wie die ressource mit mehreren Stichproben in eine Ressource mit einzeler Stichprobe aufgelöst wird. Siehe Bemerkungen.

Rückgabewert

Keine

Bemerkungen

Diese API ist besonders nützlich, wenn das resultierende Renderziel eines Renderdurchlaufs als Eingabe für einen zweiten Renderdurchlauf verwendet wird.

Die Quell- und Zielressourcen müssen denselben Ressourcentyp aufweisen und die gleichen Dimensionen aufweisen. Darüber hinaus müssen sie über kompatible Formate verfügen. Hierfür gibt es drei Szenarien:

Szenario	Requirements (Anforderungen)
Quelle und Ziel sind vorstrukturiert und typisiert.	Sowohl das Quell- als auch das Zielformat müssen identisch sein, und dieses Format muss im Format-Parameter angegeben werden.
Eine Ressource ist vorstrukturiert und typisiert, die andere ist vorstrukturiert und typlos.	Die typisierte Ressource muss über ein Format verfügen, das mit der typlosen Ressource kompatibel ist (d. h. die typisierte Ressource ist DXGI_FORMAT_R32_FLOAT und die typlose Ressource ist DXGI_FORMAT_R32_TYPELESS). Das Format der typisierten Ressource muss im Format-Parameter angegeben werden.
Quelle und Ziel sind vorstrukturiert und typlos	Sowohl die Quelle als auch das Ziel müssen das gleiche typlose Format aufweisen (d. h. beide müssen DXGI_FORMAT_R32_TYPELESS haben), und der Parameter Format muss ein Format angeben, das mit der Quelle und dem Ziel kompatibel ist (d. h. wenn beide DXGI_FORMAT_R32_TYPELESS können DXGI_FORMAT_R32_FLOAT im Parameter Format angegeben werden). Beispiel: DXGI_FORMAT_R16G16B16A16_TYPELESS Format: Das Quell- (oder Dest-Format) kann DXGI_FORMAT_R16G16B16A16_UNORM Das Dest-Format (oder das Quellformat) kann DXGI_FORMAT_R16G16B16A16_FLOAT

Szenario

Requirements (Anforderungen)

Quelle und Ziel sind vorstrukturiert und typisiert.

Sowohl das Quell- als auch das Zielformat müssen identisch sein, und dieses Format muss im Format-Parameter angegeben werden.

Eine Ressource ist vorstrukturiert und typisiert, die andere ist vorstrukturiert und typlos.

Die typisierte Ressource muss über ein Format verfügen, das mit der typlosen Ressource kompatibel ist (d. h. die typisierte Ressource ist DXGI_FORMAT_R32_FLOAT und die typlose Ressource ist DXGI_FORMAT_R32_TYPELESS). Das Format der typisierten Ressource muss im Format-Parameter angegeben werden.

Quelle und Ziel sind vorstrukturiert und typlos

Sowohl die Quelle als auch das Ziel müssen das gleiche typlose Format aufweisen (d. h. beide müssen DXGI_FORMAT_R32_TYPELESS haben), und der Parameter Format muss ein Format angeben, das mit der Quelle und dem Ziel kompatibel ist (d. h. wenn beide DXGI_FORMAT_R32_TYPELESS können DXGI_FORMAT_R32_FLOAT im Parameter Format angegeben werden).

Beispiel: DXGI_FORMAT_R16G16B16A16_TYPELESS Format:

Das Quell- (oder Dest-Format) kann DXGI_FORMAT_R16G16B16A16_UNORM
Das Dest-Format (oder das Quellformat) kann DXGI_FORMAT_R16G16B16A16_FLOAT

Anforderungen


Zielplattform	Windows
Kopfzeile	d3d11.h
Bibliothek	D3D11.lib

Weitere Informationen

ID3D11DeviceContext

Freigeben über