Edit

Share via

ID3D12GraphicsCommandList1::ResolveSubresourceRegion method (d3d12.h)

  • Article

Copy a region of a multisampled or compressed resource into a non-multisampled or non-compressed resource.

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
);

Parameters

[in] pDstResource

Type: ID3D12Resource*

SAL: In

Destination resource. Must be created with the D3D11_USAGE_DEFAULT flag and must be single-sampled unless its to be resolved from a compressed resource (D3D12_RESOLVE_MODE_DECOMPRESS); in this case it must have the same sample count as the compressed source.

[in] DstSubresource

Type: UINT

SAL: In

A zero-based index that identifies the destination subresource. Use D3D12CalcSubresource to calculate the subresource index if the parent resource is complex.

[in] DstX

Type: UINT

SAL: In

The X coordinate of the left-most edge of the destination region. The width of the destination region is the same as the width of the source rect.

[in] DstY

Type: UINT

SAL: In

The Y coordinate of the top-most edge of the destination region. The height of the destination region is the same as the height of the source rect.

[in] pSrcResource

Type: ID3D12Resource*

SAL: In

Source resource. Must be multisampled or compressed.

[in] SrcSubresource

Type: UINT

SAL: In

A zero-based index that identifies the source subresource.

[in, optional] pSrcRect

Type: D3D12_RECT*

SAL: In_opt

Specifies the rectangular region of the source resource to be resolved. Passing NULL for pSrcRect specifies that the entire subresource is to be resolved.

[in] Format

Type: DXGI_FORMAT

SAL: In

A DXGI_FORMAT that specifies how the source and destination resource formats are consolidated.

[in] ResolveMode

Type: D3D12_RESOLVE_MODE

SAL: In

Specifies the operation used to resolve the source samples.

When using the D3D12_RESOLVE_MODE_DECOMPRESS operation, the sample count can be larger than 1 as long as the source and destination have the same sample count, and source and destination may specify the same resource as long as the source rect aligns with the destination X and Y coordinates, in which case decompression occurs in place.

When using the D3D12_RESOLVE_MODE_MIN, D3D12_RESOLVE_MODE_MAX, or D3D12_RESOLVE_MODE_AVERAGE operation, the destination must have a sample count of 1.

Return value

None

Remarks

ResolveSubresourceRegion operates like ResolveSubresource but allows for only part of a resource to be resolved and for source samples to be resolved in several ways. Partial resolves can be useful in multi-adapter scenarios; for example, when the rendered area has been partitioned across adapters, each adapter might only need to resolve the portion of a subresource that corresponds to its assigned partition.

Requirements

Requirement Value
Target Platform Windows
Header d3d12.h
Library D3d12.lib
DLL D3d12.dll

See also

ID3D12GraphicsCommandList1