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