通过

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]表示 KS 管理的设备 KSDEVICE 对象。

使用中的

[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]表示 KS 管理的设备 KSDEVICE 对象。

百分比

[in]允许设备运行的完整性能百分比。 参数值为 100 表示设备没有冷却限制，并且可以在完全性能级别运行。 参数值为零表示设备必须在其最低热级别运行。 参数值介于 0 和 100 之间，指示设备性能必须限制的程度，以减少热生成。 此参数值是设备不能超过的阈值。

DeviceThermalState

[out]返回值：Avstream 确定的热状态。 如果状态更改，则会通知管道更改。 管道会通知已注册热通知的任何应用。

要求

要求 价值
标头 ks.h （包括 Ks.h）