The ID3DUserDefinedAnnotation interface enables an application to describe conceptual sections and markers within the application's code flow. An appropriately enabled tool, such as Microsoft Visual Studio Ultimate 2012, can display these sections and markers visually along the tool's Microsoft Direct3D time line, while the tool debugs the application. These visual notes allow users of such a tool to navigate to parts of the time line that are of interest, or to understand what set of Direct3D calls are produced by certain sections of the application's code.
The ID3DUserDefinedAnnotation interface inherits from the IUnknown interface. ID3DUserDefinedAnnotation also has these types of members:
The ID3DUserDefinedAnnotation interface has these methods.
|ID3DUserDefinedAnnotation::BeginEvent||Marks the beginning of a section of event code.|
|ID3DUserDefinedAnnotation::EndEvent||Marks the end of a section of event code.|
|ID3DUserDefinedAnnotation::GetStatus||Determines whether the calling application is running under a Microsoft Direct3D profiling tool.|
|ID3DUserDefinedAnnotation::SetMarker||Marks a single point of execution in code.|
The methods of ID3DUserDefinedAnnotation have no effect when the calling application is not running under a Direct3D-specific profiling tool like Visual Studio Ultimate 2012.
The ID3DUserDefinedAnnotation interface is published by Microsoft Direct3D 11 device contexts. Therefore, ID3DUserDefinedAnnotation has the same threading rules as the ID3D11DeviceContext interface, or any other context interface. For more information about Direct3D threading, see MultiThreading. To retrieve the ID3DUserDefinedAnnotation interface for the context, call the QueryInterface method for the context (for example, ID3D11DeviceContext::QueryInterface). In this call, you must pass the identifier of ID3DUserDefinedAnnotation.
The ID3DUserDefinedAnnotation interface is the Microsoft Direct3D 10 and later equivalent of the Direct3D 9 PIX functions (D3DPERF_* functions).
|Minimum supported client||Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]|
|Minimum supported server||Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]|