ID3D12GraphicsCommandList::ResolveSubresource-Methode (d3d12.h)
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:
|
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d12.h |
| Bibliothek | D3d12.lib |
| DLL | D3d12.dll |