DXGKDDI_CALIBRATEGPUCLOCK función de devolución de llamada (d3dkmddi.h)
Llamado por el subsistema del kernel de gráficos de Microsoft DirectX para calibrar las marcas de tiempo de GPU en el búfer de historial de DXGK_HISTORY_BUFFER con la hora del reloj de CPU.
Sintaxis
DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;
NTSTATUS DxgkddiCalibrategpuclock(
IN_CONST_HANDLE hAdapter,
IN UINT32 NodeOrdinal,
IN UINT32 EngineOrdinal,
OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}
Parámetros
hAdapter
Identificador del objeto de adaptador para la GPU para el que se va a obtener la información de calibración de tiempo.
El controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .
NodeOrdinal
Índice de un nodo para el que se obtendrá información de calibración de tiempo. Este nodo está dentro del adaptador físico definido por el parámetro hAdapter .
EngineOrdinal
Índice de base cero del motor, dentro del nodo que NodeOrdinal especifica, para el que se obtendrá la información de calibración de tiempo. En el caso de los adaptadores de gráficos que no forman parte de un vínculo en una configuración del adaptador de pantalla vinculado (LDA), siempre debe establecer EngineOrdinal en 0.
pClockCalibration
Puntero a una estructura de DXGKARG_CALIBRATEGPUCLOCK que proporciona información del contador de reloj de la GPU y la CPU.
Valor devuelto
Devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Comentarios
El subsistema del kernel de gráficos de DirectX usa la información devuelta en el parámetro pClockCalibration para calcular el desfase entre los relojes de GPU y CPU.
Para minimizar las imprecisiones de calibración, el controlador debe calcular los valores de los miembros GpuClockCounter y CpuClockCounter de la estructura DXGKARG_CALIBRATEGPUCLOCK lo más posible.
El subsistema del kernel de gráficos de DirectX llama a esta función con frecuencia suficiente, normalmente al menos una vez cada 30 ms, para minimizar el desfase acumulado entre las gpu y los relojes de CPU.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1,WDDM 1.3 |
| Servidor mínimo compatible | Windows Server 2012 R2 |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |