ID3D12Device8::GetCopyableFootprints1 메서드(d3d12.h)
복사할 수 있는 리소스 레이아웃을 가져옵니다. 업로드 힙에서 공간을 하위 할당할 때 앱이 D3D12_PLACED_SUBRESOURCE_FOOTPRINT 채우고 D3D12_SUBRESOURCE_FOOTPRINT 데 도움이 됩니다.
구문
void GetCopyableFootprints1(
const D3D12_RESOURCE_DESC1 *pResourceDesc,
UINT FirstSubresource,
UINT NumSubresources,
UINT64 BaseOffset,
D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
UINT *pNumRows,
UINT64 *pRowSizeInBytes,
UINT64 *pTotalBytes
);
매개 변수
pResourceDesc
형식: const D3D12_RESOURCE_DESC1*
D3D12_RESOURCE_DESC1 구조체에 대한 포인터인 리소스에 대한 설명입니다.
FirstSubresource
형식: [in] UINT
리소스의 첫 번째 하위 리소스 인덱스입니다. 유효한 값의 범위는 0에서 D3D12_REQ_SUBRESOURCES.
NumSubresources
형식: [in] UINT
리소스의 하위 리소스 수입니다. 유효한 값의 범위는 0에서 (D3D12_REQ_SUBRESOURCES - FirstSubresource)입니다.
BaseOffset
형식: UINT64
리소스에 대한 오프셋(바이트)입니다.
pLayouts
형식: [out, optional] D3D12_PLACED_SUBRESOURCE_FOOTPRINT*
각 하위 리소스의 설명 및 배치로 채울 D3D12_PLACED_SUBRESOURCE_FOOTPRINT 구조체의 배열(길이 NumSubresources)에 대한 포인터입니다.
pNumRows
형식: [out, optional] UINT*
각 하위 리소스의 행 수로 채울 정수 변수의 배열(길이 NumSubresources)에 대한 포인터입니다.
pRowSizeInBytes
형식: [out, optional] UINT64*
정수 변수의 배열( 길이 NumSubresources)에 대한 포인터이며, 각 항목은 각 하위 리소스의 행의 비패드 크기(바이트)로 채워집니다.
예를 들어 Texture2D 리소스의 너비가 32이고 픽셀당 바이트가 4이면 pRowSizeInBytes 는 128을 반환합니다.
pRowSizeInBytes는 pLayout을 검사하고 그로부터 행 피치를 가져오면 D3D12_TEXTURE_DATA_PITCH_ALIGNMENT 맞춰 256을 제공하므로 행 피치와 혼동해서는 안됩니다.
pTotalBytes
형식: [out, optional] UINT64*
총 크기(바이트)로 채울 정수 변수에 대한 포인터입니다.
반환 값
없음
설명
설명 및 예제는 ID3D12Device::GetCopyableFootprints를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 빌드 20348 |
| 지원되는 최소 서버 | Windows 10 빌드 20348 |
| 머리글 | d3d12.h |
| 라이브러리 | d3d12.lib |
| DLL | d3d12.dll |