Поделиться через

структура KSDEVICE_THERMAL_DISPATCH (ks.h)

  • Статья

Структура KSDEVICE_THERMAL_DISPATCH используется драйвером минипорта в вызове API для регистрации обратных вызовов теплового уведомления. Эта структура содержит указатели функции обратного вызова для активных и пассивных интерфейсов охлаждения.

Синтаксис

typedef struct _KSDEVICE_THERMAL_DISPATCH {
  PFNKSDEVICETHERMALACTIVECOOLING  ActiveCooling;
  PFNKSDEVICETHERMALPASSIVECOOLING PassiveCooling;
} KSDEVICE_THERMAL_DISPATCH, *PKSDEVICE_THERMAL_DISPATCH;

Члены

ActiveCooling

Уведомление о активном тепловом обратном вызове.

Подпрограмма определена следующим образом:

_IRQL_requires_max_(PASSIVE_LEVEL)
typedef
void
(*PFNKSDEVICETHERMALACTIVECOOLING)(
    _In_  PKSDEVICE KsDevice,
    _In_  BOOLEAN Engaged,
    _Out_ KSDEVICE_THERMAL_STATE* DeviceThermalState
);

KsDevice

[in] Объект KSDEVICE, представляющий устройство, управляемое KS.

Помолвленный

[in] Указывает, следует ли включать или отключать активное охлаждение. Если TRUE, драйвер должен заниматься активным охлаждением (например, путем включения вентилятора). Если FALSE, драйвер должен отключить активное охлаждение (например, отключив вентилятор).

DeviceThermalState

[out] Возвращаемое значение: тепловое состояние, определяемое avstream. Если состояние изменяет конвейер, уведомляется об изменении. Конвейер уведомляет любое приложение, зарегистрированного для тепловых уведомлений.

PassiveCooling

Уведомление о пассивном тепловом обратном вызове.

Подпрограмма определена следующим образом:

_IRQL_requires_max_(PASSIVE_LEVEL)
typedef
void
(*PFNKSDEVICETHERMALPASSIVECOOLING)(
    _In_  PKSDEVICE KsDevice,
    _In_  ULONG Percentage,
    _Out_ KSDEVICE_THERMAL_STATE* DeviceThermalState
);

KsDevice

[in] Объект KSDEVICE, представляющий устройство, управляемое KS.

Процент

[in] Процент полной производительности, с которой устройство может работать. Значение параметра 100 означает, что устройство не находится под ограничениями охлаждения и может работать на полном уровне производительности. Значение параметра равно нулю указывает, что устройство должно работать на самом низком тепловом уровне. Значение параметра от 0 до 100 указывает степень регулирования производительности устройства для уменьшения генерации тепла. Это значение параметра является пороговым значением, которое устройство не должно превышать.

DeviceThermalState

[out] Возвращаемое значение: тепловое состояние, определяемое avstream. Если состояние изменяет конвейер, уведомляется об изменении. Конвейер уведомляет любое приложение, зарегистрированного для тепловых уведомлений.

Требования

Требование Ценность
заголовка ks.h (include Ks.h)