DXGKDDI_CALIBRATEGPUCLOCK Rückruffunktion (d3dkmddi.h)
Wird vom Microsoft DirectX-Grafikkernsubsystem aufgerufen, um die GPU-Zeitstempel im DXGK_HISTORY_BUFFER-Verlaufspuffer mit der CPU-Taktzeit zu kalibrieren.
Syntax
DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;
NTSTATUS DxgkddiCalibrategpuclock(
IN_CONST_HANDLE hAdapter,
IN UINT32 NodeOrdinal,
IN UINT32 EngineOrdinal,
OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}
Parameter
hAdapter
Ein Handle für das Adapterobjekt für die GPU, für die Zeitkalibrierungsinformationen abgerufen werden sollen.
Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.
NodeOrdinal
Ein Index eines Knotens, für den Informationen zur Zeitkalibrierung abgerufen werden. Dieser Knoten befindet sich innerhalb des physischen Adapters, der durch den hAdapter-Parameter definiert wird.
EngineOrdinal
Der nullbasierte Index der Engine innerhalb des Knotens, den NodeOrdinal angibt, für den Zeitmessungskalibrierungsinformationen abgerufen werden. Für Grafikkarten, die nicht Teil eines Links in einer LDA-Konfiguration (Linked Display Adapter) sind, sollten Sie EngineOrdinal immer auf 0 festlegen.
pClockCalibration
Ein Zeiger auf eine DXGKARG_CALIBRATEGPUCLOCK-Struktur , die Taktzählerinformationen von GPU und CPU bereitstellt.
Rückgabewert
Gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.
Hinweise
Das DirectX-Grafikkernsubsystem verwendet die zurückgegebenen Informationen im pClockCalibration-Parameter , um die Abweichung zwischen gpu- und CPU-Takten zu schätzen.
Um Kalibrierungsungenauigkeiten zu minimieren, sollte der Treiber die Werte für die Elemente GpuClockCounter und CpuClockCounter der DXGKARG_CALIBRATEGPUCLOCK-Struktur so fast wie möglich gleichzeitig berechnen.
Das DirectX-Grafikkernsubsystem ruft diese Funktion häufig genug auf, in der Regel mindestens einmal alle 30 ms, um die akkumulierte Abweichung zwischen GPU- und CPU-Takten zu minimieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1,WDDM 1.3 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |