Share via

структура 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 (включая Ks.h)