Edit

Share via

ID3D10Device::ResolveSubresource method (d3d10.h)

  • Article

Copy a multisampled resource into a non-multisampled resource. This API is most useful when re-using the resulting rendertarget of one render pass as an input to a second render pass.

Syntax

void ResolveSubresource(
  [in] ID3D10Resource *pDstResource,
  [in] UINT           DstSubresource,
  [in] ID3D10Resource *pSrcResource,
  [in] UINT           SrcSubresource,
  [in] DXGI_FORMAT    Format
);

Parameters

[in] pDstResource

Type: ID3D10Resource*

Destination resource. Must be a created with the D3D10_USAGE_DEFAULT flag and be single-sampled. See ID3D10Resource.

[in] DstSubresource

Type: UINT

A zero-based index, that identifies the destination subresource. See D3D10CalcSubresource for more details.

[in] pSrcResource

Type: ID3D10Resource*

Source resource. Must be multisampled.

[in] SrcSubresource

Type: UINT

The source subresource of the source resource.

[in] Format

Type: DXGI_FORMAT

DXGI_FORMAT that indicates how the multisampled resource will be resolved to a single-sampled resource. See remarks.

Return value

None

Remarks

Both the source and destination resources must be the same resource type and have the same dimensions.

The source and destination must have compatible formats. There are three scenarios for this:

Scenario Requirements
Source and destination are prestructured and typed Both the source and destination must have identical formats and that format must be specified in the Format parameter.
One resource is prestructured and typed and the other is prestructured and typeless The typed resource must have a format that is compatible with the typeless resource (i.e. the typed resource is DXGI_FORMAT_R32_FLOAT and the typeless resource is DXGI_FORMAT_R32_TYPELESS). The format of the typed resource must be specified in the Format parameter.
Source and destination are prestructured and typeless Both the source and destination must have the same typeless format (i.e. both must have DXGI_FORMAT_R32_TYPELESS), and the Format parameter must specify a format that is compatible with the source and destination (i.e. if both are DXGI_FORMAT_R32_TYPELESS then DXGI_FORMAT_R32_FLOAT or DXGI_FORMAT_R32_UINT could be specified in the Format parameter).

Requirements

Requirement Value
Target Platform Windows
Header d3d10.h (include D3d10core)

See also

ID3D10Device Interface