ID3DUserDefinedAnnotation 인터페이스(d3d11_1.h)

  • 아티클

ID3DUserDefinedAnnotation 인터페이스를 사용하면 애플리케이션이 애플리케이션의 코드 흐름 내에서 개념적 섹션 및 표식을 설명할 수 있습니다. Microsoft Visual Studio Ultimate 2012와 같이 적절하게 사용하도록 설정된 도구는 도구의 Microsoft Direct3D 시간줄을 따라 이러한 섹션과 표식을 시각적으로 표시할 수 있으며 도구는 애플리케이션을 디버그합니다. 이러한 시각적 메모를 사용하면 이러한 도구의 사용자가 관심 있는 기간의 일부로 이동하거나 애플리케이션 코드의 특정 섹션에서 생성되는 Direct3D 호출 집합을 이해할 수 있습니다.

상속

ID3DUserDefinedAnnotation 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ID3DUserDefinedAnnotation 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ID3DUserDefinedAnnotation 인터페이스에는 이러한 메서드가 있습니다.

 
ID3DUserDefinedAnnotation::BeginEvent

이벤트 코드 섹션의 시작을 표시합니다.
ID3DUserDefinedAnnotation::EndEvent

이벤트 코드 섹션의 끝을 표시합니다.
ID3DUserDefinedAnnotation::GetStatus

호출 애플리케이션이 Microsoft Direct3D 프로파일링 도구에서 실행 중인지 여부를 확인합니다.
ID3DUserDefinedAnnotation::SetMarker

코드에서 단일 실행 지점을 표시합니다.

설명

호출 애플리케이션이 Visual Studio Ultimate 2012와 같은 Direct3D 관련 프로파일링 도구에서 실행되고 있지 않으면 ID3DUserDefinedAnnotation의 메서드가 적용되지 않습니다.

ID3DUserDefinedAnnotation 인터페이스는 Microsoft Direct3D 11 디바이스 컨텍스트에 의해 게시됩니다. 따라서 ID3DUserDefinedAnnotation 에는 ID3D11DeviceContext 인터페이스 또는 다른 컨텍스트 인터페이스와 동일한 스레딩 규칙이 있습니다. Direct3D 스레딩에 대한 자세한 내용은 다중 스레딩을 참조하세요. 컨텍스트에 대한 ID3DUserDefinedAnnotation 인터페이스를 검색하려면 컨텍스트에 대해 QueryInterface 메서드를 호출합니다(예: ID3D11DeviceContext::QueryInterface). 이 호출에서는 ID3DUserDefinedAnnotation의 식별자를 전달해야 합니다.

ID3DUserDefinedAnnotation 인터페이스는 Direct3D 9 PIX 함수(D3DPERF_* 함수)와 동일한 Microsoft Direct3D 10 이상입니다.

참고 앱에서 D3D11_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY 플래그를 설정하면 호출 D3DPerf_SetOptions(1)이 바뀝니다. 그러나 Direct3D 디버깅 도구가 앱을 후킹하지 못하도록 하려면 앱에서 ID3DUserDefinedAnnotation::GetStatus 를 호출하여 Direct3D 디버깅 도구에서 실행 중인지 확인한 다음 그에 따라 종료할 수도 있습니다.
 
BeginEvent 및 EndEvent 메서드를 쌍으로 호출해야 합니다. 이러한 메서드에 대한 호출 쌍은 애플리케이션의 호출 스택에서 더 높은 수준에서 이러한 메서드에 대한 호출 쌍 내에 중첩할 수 있습니다. 즉, "그리기 세계" 섹션에는 "그리기 나무"라는 다른 섹션이 완전히 포함될 수 있으며, 이 섹션에는 "그리기 오크"라는 섹션이 완전히 포함될 수 있습니다. EndEvent 메서드를 최신 BeginEvent 메서드와만 연결할 수 있습니다. 즉, 쌍은 겹칠 수 없습니다. 가장 최근 BeginEvent 이전 의 BeginEvent 에 대해 EndEvent를 호출할 수 없습니다. 실제로 런타임은 첫 번째 EndEvent 를 두 번째 BeginEvent를 종료하는 것으로 해석합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 d3d11_1.h

추가 정보

일반 버전 인터페이스

IUnknown