ID3D12GraphicsCommandList::ClearUnorderedAccessViewFloat 메서드(d3d12.h)
UAV(정렬되지 않은 액세스 뷰)의 모든 요소를 지정된 float 값으로 설정합니다.
구문
void ClearUnorderedAccessViewFloat(
D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
ID3D12Resource *pResource,
const FLOAT [4] Values,
UINT NumRects,
const D3D12_RECT *pRects
);
매개 변수
ViewGPUHandleInCurrentHeap
형식: [in] D3D12_GPU_DESCRIPTOR_HANDLE
지우 려는 UAV(정렬되지 않은 액세스 뷰)에 대해 초기화된 설명자를 참조하는 D3D12_GPU_DESCRIPTOR_HANDLE. 이 설명자는 SetDescriptorHeaps를 통해 명령 목록에서 설정해야 하는 셰이더 표시 설명자 힙에 있어야 합니다.
ViewCPUHandle
형식: [in] D3D12_CPU_DESCRIPTOR_HANDLE
지우 려는 UAV(순서가 지정되지 않은 액세스 뷰)에 대해 초기화된 설명자를 참조하는 비 셰이더 표시 설명자 힙의 D3D12_CPU_DESCRIPTOR_HANDLE.
중요
이 설명자는 셰이더 표시 설명자 힙에 없어야 합니다. 이는 clear를 디스패치가 아닌 고정 함수 하드웨어 작업으로 구현하는 드라이버가 설명자에서 효율적으로 읽을 수 있도록 하기 위한 것입니다. 셰이더 표시 힙은 WRITE_BACK 메모리( D3D12_HEAP_TYPE_UPLOAD 힙 형식과 유사함)에서 생성될 수 있으며 이러한 유형의 메모리에서 CPU 읽기는 엄청나게 느립니다.
pResource
형식: [in] ID3D12Resource*
지울 UAV(unordered-access-view) 리소스를 나타내는 ID3D12Resource 인터페이스에 대한 포인터입니다.
Values
형식: [in] const FLOAT[4]
순서가 지정되지 않은 액세스 보기 리소스를 채울 값을 포함하는 4개 구성 요소 배열입니다.
NumRects
형식: [in] UINT
pRects 매개 변수가 지정하는 배열의 사각형 수입니다.
pRects
형식: [in] const D3D12_RECT*
지울 리소스 뷰의 사각형에 대한 D3D12_RECT 구조체의 배열입니다. NULL이면 ClearUnorderedAccessViewFloat이 전체 리소스 뷰를 지웁니다.
반환 값
없음
설명
런타임 유효성 검사
부동 소수점 입력의 경우 런타임은 비정규화된 값을 0으로 설정합니다(NAN을 유지하면서).
UAV를 특정 비트 패턴으로 지우려면 ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint를 사용하는 것이 좋습니다.
유효성 검사 실패로 인해 ID3D12GraphicsCommandList::Close 가 E_INVALIDARG 반환됩니다.
디버그 계층
입력 값이 정규화된 범위를 벗어나면 디버그 계층에서 오류가 발생합니다.
뷰에서 참조하는 하위 리소스가 적절한 상태가 아닌 경우 디버그 계층에서 오류가 발생합니다. ClearUnorderedAccessViewFloat의 경우 상태는 D3D12_RESOURCE_STATE_UNORDERED_ACCESS 합니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | d3d12.h |
라이브러리 | D3d12.lib |
DLL | D3d12.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기