ID3D12GraphicsCommandList4::CopyRaytracingAccelerationStructure 메서드(d3d12.h)

지정된 변환을 적용하는 동안 원본 가속 구조를 대상 메모리에 복사합니다.

구문

void CopyRaytracingAccelerationStructure(
  [in] D3D12_GPU_VIRTUAL_ADDRESS                         DestAccelerationStructureData,
  [in] D3D12_GPU_VIRTUAL_ADDRESS                         SourceAccelerationStructureData,
  [in] D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE Mode
);

매개 변수

[in] DestAccelerationStructureData

대상 메모리입니다. 지정된 모드에 필요한 경우 EmitRaytracingAccelerationStructurePostbuildInfo를 미리 호출하여 필요한 크기를 검색할 수 있습니다.

대상 시작 주소는 지정된 모드에 관계없이 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT 정의된 256바이트에 맞춰야 합니다.

대상 메모리 범위는 원본과 겹칠 수 없습니다. 그렇지 않으면 결과가 정의되지 않습니다.

메모리가 가리키는 리소스 상태는 Mode 매개 변수에 따라 달라집니다. 자세한 내용은 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE 참조하세요.

[in] SourceAccelerationStructureData

지정된 모드에 따라 복사/변환할 가속 구조 또는 기타 데이터 형식의 주소입니다. 데이터는 변경되지 않고 사용할 수 있습니다. 이 작업은 SourceAccelerationStructureData 가 가리키는 데이터만 복사하며, 원본 데이터가 가리킬 수 있는 가속 구조와 같은 다른 데이터는 복사하지 않습니다. 예를 들어 최상위 가속 구조의 경우 가리키는 모든 하위 수준 가속 구조는 작업에서 복사되지 않습니다.

원본 메모리는 지정된 모드에 관계없이 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT 정의된 256바이트에 맞춰야 합니다.

메모리가 가리키는 리소스 상태는 Mode 매개 변수에 따라 달라집니다. 자세한 내용은 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE 참조하세요.

[in] Mode

수행할 복사 작업의 형식입니다. 자세한 내용은 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE 참조하세요.

반환 값

없음

설명

광선 추적 가속 구조에는 내부 포인터가 포함될 수 있고 디바이스 종속 불투명 레이아웃이 있을 수 있으므로 이를 복사하거나 조작하려면 드라이버가 요청된 작업을 처리할 수 있도록 전용 API가 필요합니다.

이 메서드는 그래픽 또는 컴퓨팅 명령 목록에서 호출할 수 있지만 번들에서는 호출할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1809[데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	d3d12.h
라이브러리	D3D12.lib
DLL	D3D12.dll

추가 정보

ID3D12GraphicsCommandList4