PFND3DDDI_SETMARKER Rückruffunktion (d3dumddi.h)

Artikel
02/06/2025

Benachrichtigt den Anzeigetreiber für den Benutzermodus, dass er einen neuen Zeitstempel generieren muss, wenn eine GPU-Arbeit seit dem letzten Aufruf von pfnSetMarkerabgeschlossen wurde. Optional implementiert durch Windows Display Driver Model (WDDM) 1.3 und höher Treiber, die auf Microsoft Direct3D Level 9-Hardware ausgeführt werden. (Siehe Anforderungen in Verbesserungen der Direct3D-Renderingleistung.) Für komplexere Hardware sollten Treiber die SetMarker--Funktion implementieren.

Syntax

PFND3DDDI_SETMARKER Pfnd3dddiSetmarker;

HRESULT Pfnd3dddiSetmarker(
  HANDLE hDevice
)
{...}

Parameter

hDevice

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

Rückgabewert

Gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn die Funktion nicht erfolgreich abgeschlossen wurde.

Bemerkungen

Wenn der Markerereignistyp aus dem Parameter Type des pfnSetMarkerMode- nicht D3DDDIMT_NONEist, muss der Anzeigetreiber für den Benutzermodus diese Prozedur mit jedem Aufruf von pfnSetMarkerausführen:

Erhöhen Sie den Wert der APISequenceNumber Member der D3DDDICB_LOGUMDMARKER-Struktur.
Ermitteln Sie, welche Kontexte der Singlethreaded Device Driver Interface (DDI) zugeordnet sind, rendern Aufrufe, die mit dem letzten Aufruf an pfnSetMarkergesendet wurden. Für jeden solchen Kontext:
1. Wenn der Befehlspuffer für den Kontext leer ist, führen Sie nichts aus.
2. Sonst:
  - Stellen Sie sicher, dass mehr Arbeitsspeicher im Verlaufspuffer des Kontexts verfügbar ist. Leeren Sie den Puffer bei Bedarf.
  - Fügen Sie einen weiteren Eintrag zum API-Sequenznummernpuffer des Kontexts hinzu, der die niedrigen 32 Bits des aktuellen APISequenceNumber-werts enthält.
  - Beispiel- und Schreibzeitstempel, die für den aktuellen Markierungsereignistyp geeignet sind.
3. Aktualisieren Sie Die Nachverfolgungsdaten, die verwendet werden, wenn pfnSetMarker- das nächste Mal aufgerufen wird.

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-	d3dumddi.h (include D3d10umddi.h)

Siehe auch

SetMarker-

pfnSetMarkerMode

Freigeben über