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 |