KSDEVICE_THERMAL_DISPATCH-Struktur (ks.h)

Die KSDEVICE_THERMAL_DISPATCH-Struktur wird vom Miniporttreiber im API-Aufruf verwendet, um Rückrufe für thermische Benachrichtigungen zu registrieren. Diese Struktur enthält die Rückruffunktionszeiger für aktive und passive Kühlschnittstellen.

Syntax

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

Member

ActiveCooling

Die aktive thermische Rückrufbenachrichtigung.

Die Routine ist wie folgt definiert:

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

KsDevice

[in] Ein KSDEVICE-Objekt , das das von KS verwaltete Gerät darstellt.

Engagiert

[in] Gibt an, ob aktive Kühlung aktiviert oder deaktiviert werden soll. Bei TRUE muss der Treiber aktiv kühlen (z. B. durch Einschalten des Lüfters). Bei FALSE muss der Treiber die aktive Kühlung deaktivieren (z. B. durch Ausschalten des Lüfters).

DeviceThermalState

[out] Rückgabewert: Avstream-bestimmter thermischer Zustand. Wenn sich der Zustand ändert, wird die Pipeline über die Änderung benachrichtigt. Die Pipeline benachrichtigt alle Apps, die für wärmetechnische Benachrichtigungen registriert sind.

PassiveCooling

Die passive thermische Rückrufbenachrichtigung.

Die Routine ist wie folgt definiert:

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

KsDevice

[in] Ein KSDEVICE-Objekt , das das von KS verwaltete Gerät darstellt.

Prozentwert

[in] Der Prozentsatz der vollen Leistung, mit dem das Gerät betrieben werden darf. Der Parameterwert 100 gibt an, dass das Gerät keine Kühleinschränkungen unterliegt und mit voller Leistung betrieben werden kann. Der Parameterwert 0 (null) gibt an, dass das Gerät mit der niedrigsten wärmetechnischen Ebene betrieben werden muss. Ein Parameterwert zwischen 0 und 100 gibt den Grad an, in dem die Leistung des Geräts gedrosselt werden muss, um die Wärmeerzeugung zu reduzieren. Dieser Parameterwert ist ein Schwellenwert, den das Gerät nicht überschreiten darf.

DeviceThermalState

[out] Rückgabewert: Avstream-bestimmter thermischer Zustand. Wenn sich der Zustand ändert, wird die Pipeline über die Änderung benachrichtigt. Die Pipeline benachrichtigt alle Apps, die für wärmetechnische Benachrichtigungen registriert sind.

Anforderungen