функция обратного вызова DXGKDDI_CALIBRATEGPUCLOCK (d3dkmddi.h)

  • Статья

Вызывается подсистемой графического ядра Microsoft DirectX для калибровки меток времени GPU в буфере журнала DXGK_HISTORY_BUFFER с использованием времени ЦП.

Синтаксис

DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;

NTSTATUS DxgkddiCalibrategpuclock(
  IN_CONST_HANDLE hAdapter,
  IN UINT32 NodeOrdinal,
  IN UINT32 EngineOrdinal,
  OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}

Параметры

hAdapter

Дескриптор объекта адаптера для GPU, для которого необходимо получить сведения о калибровке времени.

Драйвер мини-порта дисплея ранее предоставлял этот дескриптор подсистеме ядра графики DirectX в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

NodeOrdinal

Индекс узла, для которого будут получены сведения о калибровке времени. Этот узел находится в физическом адаптере, определенном параметром hAdapter .

EngineOrdinal

Отсчитываемый от нуля индекс подсистемы в узле, который указывает NodeOrdinal , для которого будут получены сведения о калибровке времени. Для графических адаптеров, которые не являются частью канала в конфигурации связанного видеоадаптера (LDA), всегда следует задать engineOrdinal значение 0.

pClockCalibration

Указатель на структуру DXGKARG_CALIBRATEGPUCLOCK , которая предоставляет сведения счетчика часов из GPU и ЦП.

Возвращаемое значение

Возвращает STATUS_SUCCESS , если она выполнена успешно; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

Подсистема графического ядра DirectX использует возвращаемые сведения в параметре pClockCalibration для оценки смещения между gpu и ЦП часов.

Чтобы свести к минимуму неточности калибровки, драйвер должен вычислить значения для членов GpuClockCounter и CpuClockCounterструктуры DXGKARG_CALIBRATEGPUCLOCK как можно более одновременно.

Подсистема графического ядра DirectX вызывает эту функцию достаточно часто ,как правило, по крайней мере один раз в 30 мс, чтобы свести к минимуму накопленный сдвиг между gpu и ЦП часов.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1,WDDM 1.3
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h
IRQL DISPATCH_LEVEL

См. также раздел

DXGKARG_CALIBRATEGPUCLOCK

DXGK_HISTORY_BUFFER

DxgkDdiAddDevice