PFND3DWDDM1_3DDI_SETMARKERMODE Rückruffunktion (d3d10umddi.h)
Benachrichtigt den Anzeigetreiber für den Benutzermodus, dass er einen Ereignisablaufverfolgungstyp für Windows (ETW) unterstützen sollte. Muss durch Windows Display Driver Model (WDDM) 1.3 und höher 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-Aufzählung, der den Typ des Markerereignisses angibt, das der Treiber unterstützen soll.
Flags
Ein UINT-Wert, der angibt, ob der Treiber benutzerdefinierte Informationen in Befehlspuffern bereitstellen soll. Wenn dieser auf D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTSfestgelegt ist, sollte der Treiber Puffer mit benutzerdefinierten Ereignisinformationen kommentieren und Instrumentbefehlspuffer verwenden. Andernfalls sollte der Treiber keine Befehlspuffer kommentieren.
Die Anmerkung kann sich in Form einer Textzeichenfolge im gebietsschema English-US oder in Form eines Indexwerts an einer Position in einer Zeichenfolgentabelle befinden. Für die letztere Option muss der Treiber auch eine Funktion implementieren, die die Zeichenfolgen beschreibt, die die Indexwerte angeben.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Befolgen Sie die folgenden Richtlinien, wenn Sie Profiltyp-Markerereignisse in Ihrem Benutzermodustreiber einrichten, der durch den D3DWDDM1_3DDI_MARKER_TYPE_PROFILE Typ angegeben wird:
- Verwenden Sie einfache Instrumentierung, die keine starke Korrelation mit Grafikbefehlsgrenzen erzeugt.
- Der Treiber muss in der Lage sein, den GPU-Zeitstempel am Ende der Grafikpipeline zu probieren.
- Verwenden Sie keine Samplingbefehle, die eine hohe Leistungsbelastung für die Grafikpipeline verursachen, z. B. Warte-für-Leerlauf-Befehle. Damit Sie Markerereignisse vom Typ "Profiltyp" instrumentieren können, sollte Ihr Treiber die Pipeline oder caches nicht leeren müssen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1,WDDM 1.3 und höher |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |