ID3D12GraphicsCommandList::CopyResource 메서드(d3d12.h)

아티클
08/23/2023

원본 리소스의 전체 내용을 대상 리소스에 복사합니다.

구문

void CopyResource(
  [in] ID3D12Resource *pDstResource,
  [in] ID3D12Resource *pSrcResource
);

매개 변수

[in] pDstResource

형식: ID3D12Resource*

대상 리소스를 나타내는 ID3D12Resource 인터페이스에 대한 포인터입니다.

[in] pSrcResource

형식: ID3D12Resource*

원본 리소스를 나타내는 ID3D12Resource 인터페이스에 대한 포인터입니다.

반환 값

없음

설명

CopyResource 작업은 GPU에서 수행되며 복사할 데이터의 크기에 따라 선형적으로 상당한 CPU 워크로드가 발생하지 않습니다.

CopyResource 를 사용하여 동일한 힙 메모리를 별칭으로 지정하는 리소스를 초기화할 수 있습니다. 자세한 내용은 CreatePlacedResource 를 참조하세요.

디버그 계층

원본 하위 리소스가 D3D12_RESOURCE_STATE_COPY_SOURCE 상태가 아니면 디버그 계층에서 오류가 발생합니다.

대상 하위 리소스가 D3D12_RESOURCE_STATE_COPY_DEST 상태가 아니면 디버그 계층에서 오류가 발생합니다.

제한

이 메서드에는 성능 향상을 위해 설계된 몇 가지 제한 사항이 있습니다. instance 경우 원본 및 대상 리소스는 다음과 같습니다.

다른 리소스여야 합니다.
동일한 형식이어야 합니다.
총 크기(바이트)와 같아야 합니다.
동일한 차원(너비, 높이, 깊이)이 있거나 호환되는 재해석 복사여야 합니다.
호환되는 DXGI 형식이 있어야 합니다. 즉, 형식이 동일하거나 적어도 동일한 형식 그룹에서 와야 합니다. 예를 들어 이러한 두 형식이 모두 DXGI_FORMAT_R32G32B32_TYPELESS 그룹에 있으므로 DXGI_FORMAT_R32G32B32_FLOAT 텍스처를 DXGI_FORMAT_R32G32B32_UINT 텍스처에 복사할 수 있습니다. CopyResource는 몇 가지 형식 형식 간에 복사할 수 있습니다( 복사 재해석 참조).
현재 매핑할 수 없습니다.

CopyResource는 복사만 지원합니다. 스트레치, 색 키 또는 혼합을 지원하지 않습니다.

CopyResource는 몇 가지 형식 형식 간에 리소스 데이터를 재해석할 수 있습니다. 자세한 내용은 아래 복사 다시 해석을 참조하세요.

깊이 스텐실 리소스를 원본 또는 대상으로 사용할 수 있습니다. 다중 샘플링 기능( DXGI_SAMPLE_DESC 참조)으로 만든 리소스는 원본과 대상 모두 다중 샘플링 수와 품질이 동일한 경우에만 원본 및 대상으로 사용할 수 있습니다. 원본과 대상이 다중 샘플링된 수와 품질이 다르거나 다중 샘플링되고 다른 하나는 다중 샘플링되지 않은 경우 CopyResource 에 대한 호출이 실패합니다. ResolveSubresource를 사용하여 다중 샘플링된 리소스를 다중 샘플링되지 않은 리소스에 resolve.

메서드는 명령 버퍼 큐에 추가할 수 있는 비동기 호출입니다. 이렇게 하면 데이터를 복사할 때 발생할 수 있는 파이프라인 중단이 제거됩니다. 자세한 내용은 성능 고려 사항을 참조하세요.

리소스에서 데이터의 일부만 복사해야 하는 경우 CopyTextureRegion 또는 CopyBufferRegion 을 사용하는 것이 좋습니다.

복사본 재해석

다음 표에서는 형식 변환의 재해석 형식에 사용할 수 있는 허용 가능한 원본 및 대상 형식을 나열합니다. 기본 데이터 값은 변환되거나 압축/압축/압축 해제되지 않으며 재해석이 예상대로 작동하려면 제대로 인코딩되어야 합니다. 자세한 내용은 Direct3D 10.1을 사용하여 형식 변환을 참조하세요.

DXGI_FORMAT_R9G9B9E5_SHAREDEXP 경우 너비와 높이가 같아야 합니다(블록당 1텍셀).

블록 압축 리소스 너비 및 높이는 압축되지 않은 리소스 너비 및 높이(블록당 16텍셀)의 4배여야 합니다. 예를 들어 압축되지 않은 256x256 DXGI_FORMAT_R32G32B32A32_UINT 텍스처는 1024x1024 DXGI_FORMAT_BC5_UNORM 압축된 텍스처에 매핑됩니다.

비트 너비	압축되지 않은 리소스	블록 압축 리소스	너비/높이 차이
32	DXGI_FORMAT_R32_UINT DXGI_FORMAT_R32_SINT	DXGI_FORMAT_R9G9B9E5_SHAREDEXP	1:1
64	DXGI_FORMAT_R16G16B16A16_UINT DXGI_FORMAT_R16G16B16A16_SINT DXGI_FORMAT_R32G32_UINT DXGI_FORMAT_R32G32_SINT	DXGI_FORMAT_BC1_UNORM[_SRGB] DXGI_FORMAT_BC4_UNORM DXGI_FORMAT_BC4_SNORM	1:4
128	DXGI_FORMAT_R32G32B32A32_UINT DXGI_FORMAT_R32G32B32A32_SINT	DXGI_FORMAT_BC2_UNORM[_SRGB] DXGI_FORMAT_BC3_UNORM[_SRGB] DXGI_FORMAT_BC5_UNORM DXGI_FORMAT_BC5_SNORM	1:4

예제

D3D12HeterogeneousMultiadapter 샘플은 다음과 같은 방식으로 CopyResource를 사용합니다.

	// Command list to copy the render target to the shared heap on the primary adapter. 
 	{ 
 		const GraphicsAdapter adapter = Primary; 
 
 
 		// Reset the copy command allocator and command list. 
 		ThrowIfFailed(m_copyCommandAllocators[m_frameIndex]-&gt;Reset()); 
 		ThrowIfFailed(m_copyCommandList-&gt;Reset(m_copyCommandAllocators[m_frameIndex].Get(), nullptr)); 
 
 
 		// Copy the intermediate render target to the cross-adapter shared resource. 
 		// Transition barriers are not required since there are fences guarding against 
 		// concurrent read/write access to the shared heap. 
 		if (m_crossAdapterTextureSupport) 
 		{ 
 			// If cross-adapter row-major textures are supported by the adapter, 
 			// simply copy the texture into the cross-adapter texture. 
 			m_copyCommandList-&gt;CopyResource(m_crossAdapterResources[adapter][m_frameIndex].Get(), m_renderTargets[adapter][m_frameIndex].Get()); 
 		} 
 		else 
 		{ 
 			// If cross-adapter row-major textures are not supported by the adapter, 
 			// the texture will be copied over as a buffer so that the texture row 
 			// pitch can be explicitly managed. 
 
 
 			// Copy the intermediate render target into the shared buffer using the 
 			// memory layout prescribed by the render target. 
 			D3D12_RESOURCE_DESC renderTargetDesc = m_renderTargets[adapter][m_frameIndex]-&gt;GetDesc(); 
 			D3D12_PLACED_SUBRESOURCE_FOOTPRINT renderTargetLayout; 
 
 
 			m_devices[adapter]-&gt;GetCopyableFootprints(&amp;renderTargetDesc, 0, 1, 0, &amp;renderTargetLayout, nullptr, nullptr, nullptr); 
 
 
 			CD3DX12_TEXTURE_COPY_LOCATION dest(m_crossAdapterResources[adapter][m_frameIndex].Get(), renderTargetLayout); 
 			CD3DX12_TEXTURE_COPY_LOCATION src(m_renderTargets[adapter][m_frameIndex].Get(), 0); 
 			CD3DX12_BOX box(0, 0, m_width, m_height); 
 
 
 			m_copyCommandList-&gt;CopyTextureRegion(&amp;dest, 0, 0, 0, &amp;src, &amp;box); 
		} 

 
		ThrowIfFailed(m_copyCommandList-&gt;Close()); 
	}

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d3d12.h
라이브러리	D3d12.lib
DLL	D3d12.dll

추가 정보

ID3D12GraphicsCommandList