ID3D12GraphicsCommandList1：：ResolveSubresourceRegion 方法 (d3d12.h)

將多重取樣或壓縮資源的區域複製到非多重取樣或非壓縮的資源。

語法

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

參數

[in] pDstResource

類型： ID3D12Resource*

SAL： In

目的地資源。 必須使用 D3D11_USAGE_DEFAULT 旗標建立，而且必須以單一取樣，除非它要從壓縮的資源解析 (D3D12_RESOLVE_MODE_DECOMPRESS) ;在此情況下，它必須有與壓縮來源相同的樣本計數。

[in] DstSubresource

類型： UINT

SAL： In

以零起始的索引，可識別目的地子資源。 如果父資源很複雜，請使用 D3D12CalcSubresource 來計算子資源索引。

[in] DstX

類型： UINT

SAL： In

目的地區域最左邊邊緣的 X 座標。 目的地區域的寬度與來源矩形的寬度相同。

[in] DstY

類型： UINT

SAL： In

目的地區域最上邊緣的 Y 座標。 目的地區域的高度與來源矩形的高度相同。

[in] pSrcResource

類型： ID3D12Resource*

SAL： In

來源資源。 必須經過多重取樣或壓縮。

[in] SrcSubresource

類型： UINT

SAL： In

以零起始的索引，可識別來源子資源。

[in, optional] pSrcRect

類型： D3D12_RECT*

SAL： In_opt

指定要解析之來源資源的矩形區域。 傳遞 pSrcRect 的 NULL 會指定要解析整個子資源。

[in] Format

類型： DXGI_FORMAT

SAL： In

指定如何合併來源和目的地資源格式的DXGI_FORMAT。

[in] ResolveMode

類型： D3D12_RESOLVE_MODE

SAL： In

指定用來解析來源範例的作業。

使用 D3D12_RESOLVE_MODE_DECOMPRESS 作業時，只要來源和目的地具有相同的樣本計數，而且來源和目的地可以指定相同的資源，只要來源 rect 與目的地 X 和 Y 座標對齊，就會就地解壓縮。

使用 D3D12_RESOLVE_MODE_MIN、 D3D12_RESOLVE_MODE_MAX或 D3D12_RESOLVE_MODE_AVERAGE 作業時，目的地的樣本計數必須為 1。

傳回值

無

備註

ResolveSubresourceRegion 的運作方式類似 ResolveSubresource ，但只允許解析資源的一部分，以及以數種方式解析來源範例。 部分解析在多配接器案例中很有用;例如，當轉譯的區域已跨配接器分割時，每個配接器可能只需要解析對應至其指派之分割區的子資源部分。

規格需求

需求	值
目標平台	Windows
標頭	d3d12.h
程式庫	D3d12.lib
Dll	D3d12.dll

另請參閱

ID3D12GraphicsCommandList1