ID3D12GraphicsCommandList::ResolveSubresource-Methode (d3d12.h)

Artikel
08/23/2023

Kopieren Sie eine Ressource mit mehreren Stichproben in eine Ressource ohne Mehrere Stichproben.

Syntax

void ResolveSubresource(
  ID3D12Resource *pDstResource,
  UINT           DstSubresource,
  ID3D12Resource *pSrcResource,
  UINT           SrcSubresource,
  DXGI_FORMAT    Format
);

Parameter

pDstResource

Typ: [in] ID3D12Resource*

Zielressource. Muss auf einem D3D12_HEAP_TYPE_DEFAULT-Heap erstellt und als Einzelsampe verwendet werden. Siehe ID3D12Resource.

DstSubresource

Typ: [in] UINT

Ein nullbasierter Index, der die Zielunterressource identifiziert. Verwenden Sie D3D12CalcSubresource , um den Unterressourcenindex zu berechnen, wenn die übergeordnete Ressource komplex ist.

pSrcResource

Typ: [in] ID3D12Resource*

Quellressource. Muss multisampled sein.

SrcSubresource

Typ: [in] UINT

Die Quellunterressource der Quellressource.

Format

Typ: [in] 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

Debugebene

Die Debugebene gibt einen Fehler aus, wenn sich die von der Quellansicht referenzierten Unterressourcen nicht im D3D12_RESOURCE_STATE_RESOLVE_SOURCE Zustand befinden.

Die Debugebene gibt einen Fehler aus, wenn sich der Zielpuffer nicht im D3D12_RESOURCE_STATE_RESOLVE_DEST Zustand befindet.

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

Anforderungen


Zielplattform	Windows
Kopfzeile	d3d12.h
Bibliothek	D3d12.lib
DLL	D3d12.dll

Weitere Informationen

ID3D12GraphicsCommandList

Unterressourcen

Freigeben über