PFND3DDDI_SETMARKERMODE callback function (d3dumddi.h)
Notifies the user-mode display driver that it should support a type of Event Tracing for Windows (ETW) marker event. Optionally implemented by Windows Display Driver Model (WDDM) 1.3 and later drivers running on Microsoft Direct3D Level 9 hardware. (See requirements in Direct3D rendering performance improvements.) For more advanced hardware, drivers should implement the SetMarkerMode function.
Syntax
PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;
HRESULT Pfnd3dddiSetmarkermode(
HANDLE hDevice,
D3DDDI_MARKERTYPE Type,
UINT Flags
)
{...}
Parameters
hDevice
A handle to the display device (graphics context).
Type
A value from the D3DDDI_MARKERTYPE enumeration that indicates the type of marker event that the driver should support.
Flags
A UINT value that indicates whether the driver should provide custom info in command buffers. If set to D3DDDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, the driver should annotate and instrument command buffers with custom event info. Otherwise, the driver should not annotate command buffers.
The annotation can be in the form of a text string in the English-US locale, or in the form of an index value to a location in a string table. For the latter option, the driver must also implement a function that describes the strings that the index values indicate.
Return value
Returns S_OK or an appropriate error result if the function does not complete successfully.
Remarks
Follow these guidelines when you set up profile-type marker events in your user-mode driver, indicated by the D3DDDIMT_PROFILE type:
- Use lightweight instrumentation that doesn't produce a strong correlation with graphics command boundaries.
- The driver must be able to sample the GPU time stamp at the end of the graphics pipeline.
- Don't use sampling commands that place a high performance burden on the graphics pipeline, such as wait-for-idle commands. To be able to instrument profile-type marker events, your driver shouldn't have to flush the pipeline or caches.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8.1,WDDM 1.3 and later |
Minimum supported server | Windows Server 2012 R2 |
Target Platform | Desktop |
Header | d3dumddi.h (include D3d10umddi.h) |