ID3D12Debug5::SetEnableAutoName 메서드(d3d12sdklayers.h)
개체의 자동 명명을 구성합니다.
구문
void SetEnableAutoName(
BOOL Enable
);
매개 변수
Enable
형식: BOOL
true 자동 이름을 사용하도록 설정하려면 이고, false 자동 명명을 사용하지 않도록 설정합니다.
반환 값
없음
설명
기본적으로 ID3D12Object::SetName 또는 ID3D12Object::SetPrivateData를 사용하여 이름을 지정하지 않는 한 개체의 이름은 지정되지 않습니다.
모든 Direct3D 12 개체의 이름을 지정하는 것이 좋습니다. 적어도 디버그 빌드에서. 실패하면 간격을 메우기 위해 자동 이름 할당을 허용하는 것이 편리할 수 있습니다. 자동 이름을 사용하도록 설정된 Direct3D 12 개체에는 디버그 계층 출력 및 DRED 페이지 오류 데이터에 사용되는 이름이 자동으로 할당됩니다.
따라서 특정 자동 명명 형식에 대한 종속성을 만들지 않도록 ID3D12Object::GetName 또는 ID3D12Object::GetPrivateData를 사용하여 자동 이름 문자열을 검색할 수 없습니다. 그러나 고유한 이름 문자열을 생성하기 위해 Direct3D 12는 생성 시 모든 ID3D12DeviceChild 개체에 할당된 LUID(로컬 고유 식별자)를 사용합니다. REFGUID 값이 WKPDID_D3D12UniqueObjectIdID3D12Object::GetPrivateData를 사용하여 해당 LUID를 검색할 수 있습니다. 고유한 개체 명명 스키마에 유용할 수 있습니다.
기존 소프트웨어를 디버깅할 때 D3DConfig 그래픽 도구 유틸리티 및 명령을 d3dconfig.exe device auto-debug-name=forced-on사용하여 자동 명명을 제어할 수 있습니다.
ID3D12Object::SetName 또는 ID3D12Object::SetPrivateData를 사용하여 이름이 지정된 모든 개체는 자동 이름 대신 할당된 이름을 사용합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 10 빌드 20348 |
| 지원되는 최소 서버 | Windows 10 빌드 20348 |
| 대상 플랫폼 | Windows |
| 헤더 | d3d12sdklayers.h |