DXGKDDI_CALIBRATEGPUCLOCK Rückruffunktion (d3dkmddi.h)
Wird vom Microsoft DirectX-Grafik-Kernel-Subsystem 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 Timing-Kalibrierungsinformationen abgerufen werden sollen.
Der Display-Miniporttreiber hat dieses Handle zuvor dem DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt.
NodeOrdinal
Ein Index eines Knotens, für den Die Anzeigedauerkalibrierungsinformationen abgerufen werden. Dieser Knoten befindet sich innerhalb des physischen Adapters, der vom hAdapter Parameter definiert wird.
EngineOrdinal
Der nullbasierte Index des Moduls innerhalb des Knotens, der NodeOrdinal- angibt, für die Zeitkalibrierungsinformationen abgerufen werden. Bei Grafikkarten, die nicht Teil einer Verbindung in einer LDA-Konfiguration (Linked Display Adapter) sind, sollten Sie immer EngineOrdinal- auf 0 festlegen.
pClockCalibration
Ein Zeiger auf eine DXGKARG_CALIBRATEGPUCLOCK-Struktur, die Taktzählerinformationen aus der GPU und CPU bereitstellt.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn er erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Das DirectX-Grafik-Kernelsubsystem verwendet die zurückgegebenen Informationen in der pClockCalibration Parameter, um die Abweichung zwischen gpu- und CPU-Takten zu schätzen.
Um Kalibrierungsgenauigkeiten zu minimieren, sollte der Treiber die Werte für die GpuClockCounter- und CpuClockCounter Member der DXGKARG_CALIBRATEGPUCLOCK Struktur so nahezu gleichzeitig wie möglich berechnen.
Das DirectX-Grafik-Kernelsubsystem ruft diese Funktion häufig genug auf, in der Regel mindestens einmal alle 30 ms, um die angesammelte Drift zwischen gpu- und CPU-Takten zu minimieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1,WDDM 1.3 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | DISPATCH_LEVEL |