PFND3DWDDM1_3DDI_SETMARKERMODE Rückruffunktion (d3d10umddi.h)

Benachrichtigt den Anzeigetreiber im Benutzermodus, dass er einen Typ von ETW-Markerereignis (Event Tracing for Windows) unterstützen soll. Muss von Windows Display Driver Model (WDDM) 1.3 und höher-Treibern implementiert werden.

Syntax

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

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

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

Type

Ein Wert aus der D3DWDDM1_3DDI_MARKER_TYPE-Enumeration , der den Typ des Markerereignisses angibt, den der Treiber unterstützen soll.

Flags

Ein UINT-Wert, der angibt, ob der Treiber benutzerdefinierte Informationen in Befehlspuffern bereitstellen soll. Bei Festlegung auf D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS sollte der Treiber Befehlspuffer mit benutzerdefinierten Ereignisinformationen kommentieren und instrumentieren. Andernfalls sollte der Treiber Befehlspuffer nicht kommentieren.

Die Anmerkung kann in Form einer Textzeichenfolge im Gebietsschema Englisch-USA oder in Form eines Indexwerts zu einer Position in einer Zeichenfolgentabelle vorliegen. Für die letztere Option muss der Treiber auch eine Funktion implementieren, die die Zeichenfolgen beschreibt, die die Indexwerte angeben.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Befolgen Sie diese Richtlinien, wenn Sie Markerereignisse vom Profiltyp in Ihrem Benutzermodustreiber einrichten, die durch den D3DWDDM1_3DDI_MARKER_TYPE_PROFILE Typ angegeben werden:

• Verwenden Sie eine einfache Instrumentierung, die keine starke Korrelation mit den Begrenzungen von Grafikbefehlen erzeugt.
• Der Treiber muss in der Lage sein, den GPU-Zeitstempel am Ende der Grafikpipeline abzutasten.
• Verwenden Sie keine Samplingbefehle, die eine hohe Leistungsbelastung für die Grafikpipeline verursachen, z. B. Wait-for-idle-Befehle. Um Profiltypmarkerereignisse instrumentieren zu können, sollte Ihr Treiber die Pipeline oder Caches nicht leeren müssen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1,WDDM 1.3 und höher
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Zielplattform	Desktop
Kopfzeile	d3d10umddi.h (include D3d10umddi.h)

Weitere Informationen

D3DWDDM1_3DDI_MARKER_TYPE