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 형식의 값입니다. 복사 없음 옵션에 대해 0을 지정하면 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 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	d3d11_1.h
라이브러리	D3D11.lib

추가 정보

ID3D11DeviceContext1