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 の呼び出しで追加のスクロール機能が有効になります。

注 ハードウェア9_x機能レベルにのみ適用されます。ID3D11DeviceContext1::UpdateSubresource1 または CopySubresourceRegion1 を使用してステージング リソースから既定のリソースにコピーすると、コピー先のコンテンツが破損する可能性があります。 これは、 NULL ソース ボックスを渡し、ソース リソースのディメンションがターゲット リソースのディメンションと異なる場合、または変換先のオフセット (x、y、z) を使用する場合に発生します。 このような場合は、ソース リソースのフル サイズであるソース ボックスを常に渡します。
 

要件

   
サポートされている最小のクライアント Windows 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d3d11_1.h
Library D3D11.lib

関連項目

ID3D11DeviceContext1