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

추가 정보

ID3D12GraphicsCommandList 인터페이스