ID3D11DeviceContext1::CopySubresourceRegion1 method (d3d11_1.h)
Copies a region from a source resource to a destination resource.
Syntax
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
);
Parameters
[in] pDstResource
Type: ID3D11Resource*
A pointer to the destination resource.
[in] DstSubresource
Type: UINT
Destination subresource index.
[in] DstX
Type: UINT
The x-coordinate of the upper-left corner of the destination region.
[in] DstY
Type: UINT
The y-coordinate of the upper-left corner of the destination region. For a 1D subresource, this must be zero.
[in] DstZ
Type: UINT
The z-coordinate of the upper-left corner of the destination region. For a 1D or 2D subresource, this must be zero.
[in] pSrcResource
Type: ID3D11Resource*
A pointer to the source resource.
[in] SrcSubresource
Type: UINT
Source subresource index.
[in, optional] pSrcBox
Type: const D3D11_BOX*
A pointer to a 3D box that defines the region of the source subresource that CopySubresourceRegion1 can copy. If NULL, CopySubresourceRegion1 copies the entire source subresource. The box must fit within the source resource.
An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, CopySubresourceRegion1 doesn't perform a copy operation.
[in] CopyFlags
Type: UINT
A D3D11_COPY_FLAGS-typed value that specifies how to perform the copy operation. If you specify zero for no copy option, CopySubresourceRegion1 behaves like ID3D11DeviceContext::CopySubresourceRegion. For existing display drivers that can't process these flags, the runtime doesn't use them.
Return value
None
Remarks
If the display driver supports overlapping, the source and destination subresources can be identical, and the source and destination regions can overlap each other. For existing display drivers that don’t support overlapping, the runtime drops calls with identical source and destination subresources, regardless of whether the regions overlap. To determine whether the display driver supports overlapping, check the CopyWithOverlap member of D3D11_FEATURE_DATA_D3D11_OPTIONS. This overlapping support enables additional scroll functionality in a call to IDXGISwapChain::Present.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps] |
Target Platform | Windows |
Header | d3d11_1.h |
Library | D3D11.lib |