DXGKDDI_CALIBRATEGPUCLOCK funzione di callback (d3dkmddi.h)
Chiamato dal sottosistema kernel della grafica Microsoft DirectX per calibrare i timestamp della GPU nel buffer della cronologia DXGK_HISTORY_BUFFER con l'ora dell'orologio della CPU.
Sintassi
DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;
NTSTATUS DxgkddiCalibrategpuclock(
IN_CONST_HANDLE hAdapter,
IN UINT32 NodeOrdinal,
IN UINT32 EngineOrdinal,
OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}
Parametri
hAdapter
Handle per l'oggetto adattatore per la GPU per cui ottenere le informazioni di calibrazione temporali.
Il driver miniport di visualizzazione precedentemente fornito questo handle al sottosistema kernel della grafica DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.
NodeOrdinal
Indice di un nodo per il quale verranno ottenute le informazioni di calibrazione temporali. Questo nodo si trova all'interno dell'adattatore fisico definito dal parametro hAdapter.
EngineOrdinal
Indice in base zero del motore, all'interno del nodo che NodeOrdinal specificato, per cui verranno ottenute le informazioni sulla calibrazione temporale. Per le schede grafiche che non fanno parte di un collegamento in una configurazione LDA (Linked Display Adapter), è sempre necessario impostare EngineOrdinal su 0.
pClockCalibration
Puntatore a una struttura DXGKARG_CALIBRATEGPUCLOCK che fornisce informazioni sul contatore dell'orologio dalla GPU e dalla CPU.
Valore restituito
Restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Osservazioni
Il sottosistema kernel della grafica DirectX usa le informazioni restituite nel parametro pClockCalibration per stimare la deriva tra gpu e clock CPU.
Per ridurre al minimo le imprecisioni di calibrazione, il driver deve calcolare i valori per il gpuClockCounter e CpuClockCounter membri della struttura DXGKARG_CALIBRATEGPUCLOCK il più possibile.
Il sottosistema kernel della grafica DirectX chiama questa funzione abbastanza spesso, in genere almeno una volta ogni 30 ms, per ridurre al minimo la deviazione accumulata tra gpu e clock CPU.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8.1,WDDM 1.3 |
| server minimo supportato | Windows Server 2012 R2 |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |