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 子資源，這必須是零。

[in] DstZ

類型： UINT

目的地區域左上角的 z 座標。 如果是 1D 或 2D 子資源，這必須是零。

[in] pSrcResource

類型： ID3D11Resource*

來源資源的指標。

[in] SrcSubresource

類型： UINT

來源子資源索引。

[in, optional] pSrcBox

類型：const D3D11_BOX*

3D 方塊的指標，定義 CopySubresourceRegion1 可以複製的來源子資源區域。 如果 為 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 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	適用于 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d3d11_1.h
程式庫	D3D11.lib

另請參閱

ID3D11DeviceContext1