Partager via

structure KSDEVICE_THERMAL_DISPATCH (ks.h)

  • Article

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.

Fiancé

[in] Indique s’il faut engager ou désengager le refroidissement actif. Si TRUE, le pilote doit activer le refroidissement actif (par exemple, en activant le ventilateur). Si FAUX, le pilote doit désactiver 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 complètes auxquelles l’appareil est autorisé à fonctionner. Une valeur de paramètre de 100 indique que l’appareil n’est pas soumis à des restrictions de refroidissement et peut fonctionner au niveau complet des performances. Une valeur de paramètre de 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 génération 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.

Exigences

Exigence Valeur
d’en-tête ks.h (include Ks.h)