共用方式為

KSDEVICE_THERMAL_DISPATCH結構 （ks.h）

  • 發行項

API 呼叫中的迷你埠驅動程式會使用 KSDEVICE_THERMAL_DISPATCH 結構來註冊熱通知回呼。 此結構包含主動和被動冷卻介面的回調函式指標。

語法

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）