ID3D11DeviceContext1::CopySubresourceRegion1 メソッド (d3d11_1.h)
ソース リソースからターゲット リソースにリージョンをコピーします。
構文
void CopySubresourceRegion1(
[in] ID3D11Resource *pDstResource,
[in] UINT DstSubresource,
[in] UINT DstX,
[in] UINT DstY,
[in] UINT DstZ,
[in] ID3D11Resource *pSrcResource,
[in] UINT SrcSubresource,
[in, optional] const D3D11_BOX *pSrcBox,
[in] UINT CopyFlags
);
パラメーター
[in] pDstResource
種類: ID3D11Resource*
宛先リソースへのポインター。
[in] DstSubresource
型: UINT
変換先サブリソース インデックス。
[in] DstX
型: UINT
変換先領域の左上隅の x 座標。
[in] DstY
型: UINT
宛先領域の左上隅の y 座標。 1D サブリソースの場合、これは 0 である必要があります。
[in] DstZ
型: UINT
変換先領域の左上隅の z 座標。 1D または 2D サブリソースの場合、これは 0 である必要があります。
[in] pSrcResource
種類: ID3D11Resource*
ソース リソースへのポインター。
[in] SrcSubresource
型: UINT
ソース サブリソース インデックス。
[in, optional] pSrcBox
型: const D3D11_BOX*
CopySubresourceRegion1 でコピーできるソース サブリソースの領域を定義する 3D ボックスへのポインター。 NULL の場合、CopySubresourceRegion1 はソース サブリソース全体をコピーします。 ボックスはソース リソース内に収まる必要があります。
空のボックスを使用すると、操作が不要になります。 上の値が下の値以上であるか、左の値が右の値以上であるか、前面の値が戻り値以上の場合、ボックスは空です。 ボックスが空の場合、 CopySubresourceRegion1 はコピー操作を実行しません。
[in] CopyFlags
型: UINT
コピー操作の実行方法を指定する D3D11_COPY_FLAGS型指定の値。 コピー オプションを指定しない場合、 CopySubresourceRegion1 は ID3D11DeviceContext::CopySubresourceRegion のように動作します。 これらのフラグを処理できない既存のディスプレイ ドライバーの場合、ランタイムではそれらを使用しません。
戻り値
なし
解説
ディスプレイ ドライバーが重複をサポートしている場合は、ソースと宛先のサブリソースを同じにすることができ、ソースと宛先の領域が互いに重複する可能性があります。 重複をサポートしていない既存のディスプレイ ドライバーの場合、ランタイムは、リージョンが重複しているかどうかに関係なく、同じソースと宛先のサブリソースを持つ呼び出しを削除します。 ディスプレイ ドライバーが重複をサポートしているかどうかを確認するには、D3D11_FEATURE_DATA_D3D11_OPTIONS の CopyWithOverlap メンバーをチェックします。 この重複するサポートにより、 IDXGISwapChain::P resent の呼び出しで追加のスクロール機能が有効になります。
要件
サポートされている最小のクライアント | Windows 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | d3d11_1.h |
Library | D3D11.lib |