KsGenerateThermalEvent function (ks.h)

This function is used by clients (miniport drivers) that do not want to subscribe to the thermal manager, but want to do their own thermal management.

There is a check that verifies whether the miniport driver has the query interface support for a thermal manager (for example, the device is actively managed by a thermal manager). In cases of devices managed by a thermal manager, this call is rejected.

Syntax

KSDDKAPI NTSTATUS KsGenerateThermalEvent(
  [in] PVOID                  Object,
  [in] KSDEVICE_THERMAL_STATE Value
);

Parameters

[in] Object

Can be KSDEVICE, KSFILTER, or KSPIN. Depending on the object passed, the thermal notification is sent device-wide, filter-wide, or to the pin.

[in] Value

KSDEVICE_THERMAL_STATE_LOW or KSDEVICE_THERMAL_STATE_HIGH

Return value

Returns STATUS_SUCCESS for success and STATUS_INVALID_DEVICE_REQUEST if the parameters are incorrect.

Requirements

Requirement	Value
Target Platform	Universal
Header	ks.h
Library	Ks.lib