ID3D12GraphicsCommandList1::ResolveSubresourceRegion-Methode (d3d12.h)

Kopieren Sie einen Bereich einer multisampledierten oder komprimierten Ressource in eine nicht mehrfach oder nicht komprimierte Ressource.

Syntax

void ResolveSubresourceRegion(
  [in]           ID3D12Resource     *pDstResource,
  [in]           UINT               DstSubresource,
  [in]           UINT               DstX,
  [in]           UINT               DstY,
  [in]           ID3D12Resource     *pSrcResource,
  [in]           UINT               SrcSubresource,
  [in, optional] D3D12_RECT         *pSrcRect,
  [in]           DXGI_FORMAT        Format,
  [in]           D3D12_RESOLVE_MODE ResolveMode
);

Parameter

[in] pDstResource

Typ: ID3D12Resource*

SAL: In

Zielressource. Muss mit dem D3D11_USAGE_DEFAULT-Flag erstellt werden und muss mit einer einzelnen Stichprobe erstellt werden, es sei denn, es wird aus einer komprimierten Ressource aufgelöst (D3D12_RESOLVE_MODE_DECOMPRESS); in diesem Fall muss die gleiche Stichprobenanzahl wie die komprimierte Quelle vorhanden sein.

[in] DstSubresource

Typ: UINT

SAL: In

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

[in] DstX

Typ: UINT

SAL: In

Die X-Koordinate des linken Rands des Zielbereichs. Die Breite des Zielbereichs entspricht der Breite des Quellrekts.

[in] DstY

Typ: UINT

SAL: In

Die Y-Koordinate des obersten Rands des Zielbereichs. Die Höhe des Zielbereichs entspricht der Höhe des Quellrekt.

[in] pSrcResource

Typ: ID3D12Resource*

SAL: In

Quellressource. Muss multisamped oder komprimiert sein.

[in] SrcSubresource

Typ: UINT

SAL: In

Ein nullbasierter Index, der die Quellunterressource identifiziert.

[in, optional] pSrcRect

Typ: D3D12_RECT*

SAL: In_opt

Gibt den rechteckigen Bereich der zu auflösenden Quellressource an. Das Übergeben von NULL für pSrcRect gibt an, dass die gesamte Unterressource aufgelöst werden soll.

[in] Format

Typ: DXGI_FORMAT

SAL: In

Eine DXGI_FORMAT, die angibt, wie die Quell- und Zielressourcenformate konsolidiert werden.

[in] ResolveMode

Typ: D3D12_RESOLVE_MODE

SAL: In

Gibt den Vorgang an, der zum Auflösen der Quellbeispiele verwendet wird.

Bei Verwendung des vorgangs D3D12_RESOLVE_MODE_DECOMPRESS kann die Stichprobenanzahl größer als 1 sein, solange Quelle und Ziel die gleiche Stichprobenanzahl aufweisen, und Quelle und Ziel können dieselbe Ressource angeben, solange das Quellrekt an den X- und Y-Zielkoordinaten ausgerichtet ist. In diesem Fall erfolgt die Dekomprimierung.

Bei Verwendung des vorgangs D3D12_RESOLVE_MODE_MIN, D3D12_RESOLVE_MODE_MAX oder D3D12_RESOLVE_MODE_AVERAGE muss das Ziel eine Stichprobenanzahl von 1 aufweisen.

Rückgabewert

Keine

Bemerkungen

ResolveSubresourceRegion funktioniert wie ResolveSubresource , ermöglicht jedoch, dass nur ein Teil einer Ressource aufgelöst wird und Quellbeispiele auf verschiedene Arten aufgelöst werden. Partielle Auflösungen können in Szenarien mit mehreren Adaptern nützlich sein. Wenn der gerenderte Bereich beispielsweise adapterübergreifend partitioniert wurde, muss jeder Adapter möglicherweise nur den Teil einer Unterressource auflösen, der der zugewiesenen Partition entspricht.

Anforderungen

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

Weitere Informationen

ID3D12GraphicsCommandList1