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 の場合は、デバイスが最も低い熱レベルで動作する必要があることを示します。 0 ~ 100 のパラメーター値は、発熱を減らすためにデバイスのパフォーマンスを調整する必要がある程度を示します。 このパラメーター値は、デバイスが超えてはならないしきい値です。

DeviceThermalState

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

必要条件

要件	価値
ヘッダー	ks.h (Ks.h を含む)