구문
매개 변수
ViewGPUHandleInCurrentHeap형식: D3D12_GPU_DESCRIPTOR_HANDLE 지울 정렬되지 않은 액세스 뷰(UAV)에 대한 초기화된 디스크립터를 참조하는 D3D12_GPU_DESCRIPTOR_HANDLE입니다. 이 디스크립터는 셰이더 표시 디스크립터 힙에 있어야 하며, 이 힙은 SetDescriptorHeaps를 통해 명령 목록에 설정되어야 합니다. ViewCPUHandle
형식: D3D12_CPU_DESCRIPTOR_HANDLE 지울 정렬되지 않은 액세스 뷰(UAV)에 대한 초기화된 디스크립터를 참조하는 비셰이더 표시 디스크립터 힙의 D3D12_CPU_DESCRIPTOR_HANDLE입니다.
이 디스크립터는 셰이더 표시 디스크립터 힙에 있어서는 안 됩니다. 이는 셰이더 표시 힙이 WRITE_BACK 메모리(D3D12_HEAP_TYPE_UPLOAD 힙 유형과 유사)에서 생성될 수 있고 이 유형의 메모리에서 CPU 읽기는 매우 느리므로, 클리어를 (디스패치가 아닌) 고정 함수 하드웨어 작업으로 구현하는 드라이버가 디스크립터에서 효율적으로 읽을 수 있도록 하기 위함입니다.
형식: ID3D12Resource * 지울 정렬되지 않은 액세스 뷰(UAV) 리소스를 나타내는 ID3D12Resource 인터페이스에 대한 포인터입니다. Values
형식: const FLOAT * 정렬되지 않은 액세스 뷰 리소스를 채울 값이 포함된 4개 구성 요소 배열입니다. NumRects
형식: UINT pRects 매개 변수가 지정하는 배열의 사각형 수입니다. pRects
형식: const D3D12_RECT * 지울 리소스 뷰의 사각형에 대한 D3D12_RECT 구조체 배열입니다. NULL이면 ClearUnorderedAccessViewFloat는 전체 리소스 뷰를 지웁니다.
반환 값
형식: void 없음.설명
런타임 유효성 검사
부동 소수점 입력의 경우 런타임은 비정규화된 값을 0으로 설정합니다(NAN은 보존). UAV를 특정 비트 패턴으로 지우려면 ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint를 사용하는 것을 고려하세요. 유효성 검사에 실패하면 ID3D12GraphicsCommandList::Close 호출이 E_INVALIDARG를 반환합니다.디버그 레이어
입력 값이 정규화된 범위를 벗어나는 경우 디버그 레이어는 오류를 발생시킵니다. 뷰가 참조하는 하위 리소스가 적절한 상태가 아닌 경우 디버그 레이어는 오류를 발생시킵니다. ClearUnorderedAccessViewFloat의 경우 상태는 D3D12_RESOURCE_STATE_UNORDERED_ACCESS여야 합니다.요구 사항
헤더: d3d12_xs.h 또는 d3d12_x.h라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군