Freigeben über

KSDEVICE_THERMAL_DISPATCH Struktur (ks.h)

  • Artikel

Die KSDEVICE_THERMAL_DISPATCH-Struktur wird vom Miniporttreiber im API-Aufruf verwendet, um Thermische Benachrichtigungsrückrufe 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;

Angehörige

ActiveCooling

Die aktive thermische Rückrufbenachrichtigung.

Die Routine wird 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.

Verlobt

[in] Gibt an, ob aktive Kühlung aktiviert oder deaktiviert werden soll. Wenn TRUE, muss der Fahrer die aktive Kühlung aktivieren (z. B. durch Einschalten des Lüfters). Wenn FALSE, muss der Treiber die aktive Kühlung aufheben (z. B. durch Deaktivieren des Lüfters).

DeviceThermalState

[out] Rückgabewert: Avstream-bestimmter Thermischer Zustand. Wenn der Zustand ändert, wird die Pipeline über die Änderung benachrichtigt. Die Pipeline benachrichtigt alle apps, die für thermische Benachrichtigungen registriert sind.

PassiveCooling

Die passive thermische Rückrufbenachrichtigung.

Die Routine wird 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.

Prozentsatz

[in] Der Prozentsatz der vollständigen Leistung, mit der das Gerät betrieben werden darf. Ein Parameterwert von 100 gibt an, dass das Gerät unter keinen Kühleinschränkungen liegt und auf vollem Leistungsniveau ausgeführt werden kann. Ein Parameterwert von Null gibt an, dass das Gerät auf der niedrigsten Thermischen Ebene ausgeführt 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 der Zustand ändert, wird die Pipeline über die Änderung benachrichtigt. Die Pipeline benachrichtigt alle apps, die für thermische Benachrichtigungen registriert sind.

Anforderungen

Anforderung Wert
Header- ks.h (enthalten Ks.h)