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

[入力] KS によって 管理されるデバイスを表す KSDEVICE オブジェクト。

従事

[入力]アクティブな冷却を開始または解除するかどうかを示します。 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

[入力] KS によって 管理されるデバイスを表す KSDEVICE オブジェクト。

パーセント

[入力]デバイスの動作が許可されている完全なパフォーマンスの割合。 パラメーター値 100 は、デバイスが冷却制限を受けず、完全なパフォーマンス レベルで動作できることを示します。 パラメーター値 0 は、デバイスが最も低い温度レベルで動作する必要があることを示します。 0 ~ 100 のパラメーター値は、発熱を減らすためにデバイスのパフォーマンスを調整する必要がある程度を示します。 このパラメーター値は、デバイスが超えてはならないしきい値です。

DeviceThermalState

[out]戻り値: Avstream によって決定された温度状態。 状態が変更された場合、パイプラインには変更が通知されます。 パイプラインは、温度通知用に登録されたすべてのアプリに通知します。

要件