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

宛先リソース。 圧縮されたリソース (D3D12_RESOLVE_MODE_DECOMPRESS) から解決されない限り、D3D11_USAGE_DEFAULT フラグを使用して作成し、単一サンプリングする必要があります。この場合は、圧縮されたソースと同じサンプル数が必要です。

[in] DstSubresource

型: UINT

SAL: In

宛先サブリソースを識別する 0 から始まるインデックス。 親リソースが複雑な場合は、 D3D12CalcSubresource を使用してサブリソース インデックスを計算します。

[in] DstX

型: UINT

SAL: In

宛先領域の左端の X 座標。 変換先の領域の幅は、ソースの rect の幅と同じです。

[in] DstY

型: UINT

SAL: In

宛先領域の上端の Y 座標。 変換先の領域の高さは、ソース の rect の高さと同じです。

[in] pSrcResource

種類: ID3D12Resource*

SAL: In

ソース リソース。 マルチサンプリングまたは圧縮する必要があります。

[in] SrcSubresource

型: UINT

SAL: In

ソース サブリソースを識別する 0 から始まるインデックス。

[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操作を使用する場合、ソースと宛先のサンプル数が同じである限り、サンプル数は 1 より大きくすることができ、ソースの rect が変換先の X 座標と Y 座標と一致している限り、ソースと宛先は同じリソースを指定できます。この場合、圧縮解除が行われます。

D3D12_RESOLVE_MODE_MIN、D3D12_RESOLVE_MODE_MAX、またはD3D12_RESOLVE_MODE_AVERAGE操作を使用する場合、変換先のサンプル数は 1 である必要があります。

戻り値

なし

解説

ResolveSubresourceRegion は ResolveSubresource と同様に動作しますが、リソースの一部のみを解決し、ソース サンプルをいくつかの方法で解決できます。 部分解決は、マルチアダプターのシナリオで役立ちます。たとえば、レンダリングされた領域がアダプター間でパーティション分割されている場合、各アダプターは、割り当てられたパーティションに対応するサブリソースの部分のみを解決する必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー d3d12.h
Library D3d12.lib
[DLL] D3d12.dll

こちらもご覧ください

ID3D12GraphicsCommandList1