Skip to main content
명령 할당자와 연결된 메모리를 재사용하도록 지시합니다.

구문

매개 변수

반환 값

형식: HRESULT 명령 할당자를 참조하는 활성 기록 중인 명령 목록이 있는 경우 이 메서드는 E_FAIL을 반환합니다. 이 경우 디버그 레이어도 오류를 발생시킵니다. 다른 가능한 반환 값은 Direct3D 12 반환 코드를 참조하세요.

설명

앱은 명령 할당자와 연결된 메모리를 재사용하기 위해 Reset을 호출합니다. 이 Reset 호출을 통해, 런타임과 드라이버는 GPU가 명령 할당자로 명령을 기록한 명령 목록을 더 이상 실행하고 있지 않다고 판단합니다. ID3D12GraphicsCommandList::Reset과 달리, 명령 목록이 여전히 실행 중일 때 명령 할당자에서 Reset을 호출하는 것은 권장되지 않습니다. 할당자에 명령을 기록한 명령 목록에 대한 보류 중인 GPU 참조가 없음을 증명할 수 없는 경우, 디버그 레이어는 경고를 발생시킵니다. Reset이 동일한 할당자 객체에 대해 여러 스레드에서 동시에 호출되는 경우, 디버그 레이어는 오류를 발생시킵니다.

예제

D3D12HelloTriangle 샘플은 다음과 같이 ID3D12CommandAllocator::Reset을 사용합니다:
D3D12 참조의 예제 코드를 참조하세요.

요구 사항

헤더: d3d12_xs.h 또는 d3d12_x.h
라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군

함께 보기

ID3D12CommandAllocator
마지막 수정일 2026년 8월 24일