Edit

PFND3DWDDM1_3DDI_SETMARKERMODE callback function (d3d10umddi.h)

  • Article

Notifies the user-mode display driver that it should support a type of Event Tracing for Windows (ETW) marker event. Must be implemented by Windows Display Driver Model (WDDM) 1.3 and later drivers.

Syntax

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

Type

A value from the D3DWDDM1_3DDI_MARKER_TYPE 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 D3DWDDM1_3DDI_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

None

Remarks

The driver can use the pfnSetErrorCb callback function to set an error code.

Follow these guidelines when you set up profile-type marker events in your user-mode driver, indicated by the D3DWDDM1_3DDI_MARKER_TYPE_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 d3d10umddi.h (include D3d10umddi.h)

See also

D3DWDDM1_3DDI_MARKER_TYPE