PFND3D10DDI_RESOURCERESOLVESUBRESOURCE callback function

The ResourceResolveSubresource function resolves multiple samples to one pixel.

Syntax


PFND3D10DDI_RESOURCERESOLVESUBRESOURCE ResourceResolveSubresource;

VOID APIENTRY ResourceResolveSubresource(
  _In_ D3D10DDI_HDEVICE   hDevice,
  _In_ D3D10DDI_HRESOURCE hDstResource,
  _In_ UINT               DstSubresource,
  _In_ D3D10DDI_HRESOURCE hSrcResource,
  _In_ UINT               SrcSubresource,
  _In_ DXGI_FORMAT        ResolveFormat
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

hDstResource [in]

A handle to the destination resource to resolve to. This resource must have been created as D3D10_USAGE_DEFAULT and single sampled.

DstSubresource [in]

An index that indicates the destination subresource to resolve to.

hSrcResource [in]

A handle to the source resource to resolve from.

SrcSubresource [in]

An index that indicates the source subresource to resolve from.

ResolveFormat [in]

A DXGI_FORMAT-typed value that indicates how to interpret the contents of the resolved resource.

Return value

None

The driver can use the pfnSetErrorCb callback function to set an error code.

Remarks

The algorithm to resolve multiple samples to one pixel depends on the implementation.

The resolve operation shares similar restrictions to copy operations that occur in calls to the ResourceCopy and ResourceCopyRegion functions. That is, both source and destination resources must be the same type (for example, Texture2D), and no stretching or format conversions can occur. The driver can resolve only a whole subresource; therefore, both the source and destination subresources must be equal in dimensions. Because of typeless resources, the following interactions can exist with either the source or destination resource format:

  • If each resource is prestructured plus typed, both resources must have the same format type, and that format type must match the format type that was passed in the ResolveFormat parameter (for example, all R32_FLOAT).

  • If one resource is prestructured plus typeless, the prestructured-plus-typed resource's format must be compatible with the typeless format, and the format type that was passed in the ResolveFormat parameter must match the prestructured-plus-typed format (for example, if the source format is R32_TYPELESS, and the destination format and ResolveFormat are R32_FLOAT).

  • If both resources are prestructured plus typeless, they must be equal formats, and the format type that was passed in the ResolveFormat parameter can be any format that is compatible with the typeless format. (for example, if the source and destination format are R32_TYPELESS, and ResolveFormat is R32_FLOAT or R32_UINT).

Requirements

Target platform

Desktop

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

pfnSetErrorCb
ResourceCopy
ResourceCopyRegion

 

 

Send comments about this topic to Microsoft

Show: