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 del 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 de la GPU para el que se va a obtener la información de calibración de tiempo.
El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel gráfico de DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice función.
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 qué información de calibración de tiempo se obtendrá. 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.
Observaciones
El subsistema del kernel de gráficos de DirectX usa la información devuelta en el parámetro pClockCalibration para calcular el desfase entre la GPU y los relojes de CPU.
Para minimizar las imprecisiones de calibración, el controlador debe calcular los valores de la gpuClockCounter y CpuClockCounter miembros de la estructura de DXGKARG_CALIBRATEGPUCLOCK lo más simultáneamente posible.
El subsistema del kernel de gráficos directX llama a esta función con frecuencia, normalmente al menos una vez cada 30 ms, para minimizar el desfase acumulado entre las gpu y los relojes de CPU.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8.1,WDDM 1.3 |
| servidor mínimo admitido | Windows Server 2012 R2 |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h |
| irQL | DISPATCH_LEVEL |