PFND3DDDI_SETMARKER Rückruffunktion (d3dumddi.h)
Benachrichtigt den Benutzermodusanzeigetreiber, dass er einen neuen Zeitstempel generieren muss, wenn seit dem letzten Aufruf von pfnSetMarker eine GPU-Arbeit abgeschlossen wurde. Optional implementiert durch Windows Display Driver Model (WDDM) 1.3 und höhere Treiber, die auf Microsoft Direct3D Level 9 Hardware ausgeführt werden. (Siehe Anforderungen in Direct3D-Rendering-Leistungsverbesserungen.) Für erweiterte 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 wird.
Hinweise
Wenn der Markerereignistyp aus dem Type-Parameter der funktion pfnSetMarkerMode nicht D3DDDIMT_NONE ist, muss der Benutzermodusanzeigetreiber diese Prozedur mit jedem Aufruf von pfnSetMarker ausführen:
- Erhöhen Sie den Wert des APISequenceNumber-Members der D3DDDICB_LOGUMDMARKER-Struktur .
- Ermitteln Sie, welche Kontexte, die mit singlethreaded Device Driver Interface (DDI) verknüpft sind, rendern, die gesendeten Aufrufe mit dem letzten Aufruf von pfnSetMarker funktionieren. Für jeden solchen Kontext:
- Wenn der Befehlspuffer für den Kontext leer ist, tun Sie nichts.
- Andernfalls:
- Stellen Sie sicher, dass im Verlaufspuffer des Kontexts mehr Arbeitsspeicher verfügbar ist. Leeren Sie den Puffer bei Bedarf.
- Fügen Sie dem API-Sequenznummernpuffer des Kontexts einen weiteren Eintrag hinzu, der die niedrigen 32 Bits des aktuellen APISequenceNumber-Werts enthält.
- Beispiel- und Schreibzeitstempel, die für den aktuellen Markerereignistyp geeignet sind.
- Aktualisieren Sie Die Nachverfolgungsdaten, die beim nächsten Aufruf von pfnSetMarker verwendet werden.
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 | d3dumddi.h (einschließlich D3d10umddi.h) |