estructura KSDEVICE_THERMAL_DISPATCH (ks.h)

El controlador de minipuerto de la llamada API usa la estructura KSDEVICE_THERMAL_DISPATCH para registrar devoluciones de llamada de notificación térmica. Esta estructura contiene los punteros de función de devolución de llamada para interfaces de refrigeración activas y pasivas.

Sintaxis

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

Miembros

ActiveCooling

Notificación de devolución de llamada térmica activa.

La rutina se define de la siguiente manera:

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

KsDevice

[in] Un objeto KSDEVICE que representa el dispositivo administrado por KS.

Contratado

[in] Indica si se debe activar o desasociar la refrigeración activa. Si es TRUE, el controlador debe activar la refrigeración activa (por ejemplo, al encender el ventilador). Si es FALSE, el controlador debe desasociar la refrigeración activa (por ejemplo, apagando el ventilador).

DeviceThermalState

[out] Valor devuelto: estado térmico determinado por Avstream. Si el estado cambia, se notifica el cambio a la canalización. La canalización notifica a cualquier aplicación registrada para las notificaciones térmicas.

PassiveCooling

Notificación de devolución de llamada térmica pasiva.

La rutina se define de la siguiente manera:

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

KsDevice

[in] Un objeto KSDEVICE que representa el dispositivo administrado por KS.

Porcentaje

[in] Porcentaje de rendimiento completo en el que el dispositivo puede funcionar. Un valor de parámetro de 100 indica que el dispositivo no tiene restricciones de refrigeración y puede funcionar a nivel de rendimiento completo. Un valor de parámetro de cero indica que el dispositivo debe funcionar en su nivel térmico más bajo. Un valor de parámetro entre 0 y 100 indica el grado en que se debe limitar el rendimiento del dispositivo para reducir la generación de calor. Este valor de parámetro es un umbral que el dispositivo no debe superar.

DeviceThermalState

[out] Valor devuelto: estado térmico determinado por Avstream. Si el estado cambia, se notifica el cambio a la canalización. La canalización notifica a cualquier aplicación registrada para las notificaciones térmicas.

Requisitos

Requisito	Valor
Header	ks.h (incluye Ks.h)