structure KSDEVICE_THERMAL_DISPATCH (ks.h)

La structure KSDEVICE_THERMAL_DISPATCH est utilisée par le pilote miniport dans l’appel d’API pour inscrire les rappels de notification thermique. Cette structure contient les pointeurs de fonction de rappel pour les interfaces de refroidissement actif et passif.

Syntaxe

typedef struct _KSDEVICE_THERMAL_DISPATCH {
  PFNKSDEVICETHERMALACTIVECOOLING  ActiveCooling;
  PFNKSDEVICETHERMALPASSIVECOOLING PassiveCooling;
} KSDEVICE_THERMAL_DISPATCH, *PKSDEVICE_THERMAL_DISPATCH;

Membres

ActiveCooling

Notification de rappel thermique active.

La routine est définie comme suit :

_IRQL_requires_max_(PASSIVE_LEVEL)
typedef
void
(*PFNKSDEVICETHERMALACTIVECOOLING)(
    _In_  PKSDEVICE KsDevice,
    _In_  BOOLEAN Engaged,
    _Out_ KSDEVICE_THERMAL_STATE* DeviceThermalState
);

KsDevice

[in] Objet KSDEVICE représentant l’appareil géré par KS.

Engagé

[in] Indique s’il faut engager ou désengager le refroidissement actif. Si la valeur est TRUE, le pilote doit activer le refroidissement actif (par exemple, en activant le ventilateur). Si la valeur est FALSE, le pilote doit désengager le refroidissement actif (par exemple, en désactivant le ventilateur).

DeviceThermalState

[out] Valeur de retour : état thermique déterminé par Avstream. Si l’état change, le pipeline est averti de la modification. Le pipeline avertit toute application inscrite pour les notifications thermiques.

PassiveCooling

Notification de rappel thermique passif.

La routine est définie comme suit :

_IRQL_requires_max_(PASSIVE_LEVEL)
typedef
void
(*PFNKSDEVICETHERMALPASSIVECOOLING)(
    _In_  PKSDEVICE KsDevice,
    _In_  ULONG Percentage,
    _Out_ KSDEVICE_THERMAL_STATE* DeviceThermalState
);

KsDevice

[in] Objet KSDEVICE représentant l’appareil géré par KS.

Pourcentage

[in] Pourcentage de performances totales auxquelles l’appareil est autorisé à fonctionner. Une valeur de paramètre de 100 indique que l’appareil n’est soumis à aucune restriction de refroidissement et peut fonctionner à un niveau de performances complet. Une valeur de paramètre égale à zéro indique que l’appareil doit fonctionner à son niveau thermique le plus bas. Une valeur de paramètre comprise entre 0 et 100 indique le degré auquel les performances de l’appareil doivent être limitées pour réduire la production de chaleur. Cette valeur de paramètre est un seuil que l’appareil ne doit pas dépasser.

DeviceThermalState

[out] Valeur de retour : état thermique déterminé par Avstream. Si l’état change, le pipeline est averti de la modification. Le pipeline avertit toute application inscrite pour les notifications thermiques.

Configuration requise

Condition requise	Valeur
En-tête	ks.h (inclure Ks.h)