Condividi tramite

struttura KSDEVICE_THERMAL_DISPATCH (ks.h)

  • Articolo

La struttura KSDEVICE_THERMAL_DISPATCH viene usata dal driver miniport nella chiamata API per registrare i callback di notifica termica. Questa struttura contiene i puntatori a funzione di callback per interfacce di raffreddamento attive e passive.

Sintassi

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

Membri

ActiveCooling

Notifica di callback termica attiva.

La routine è definita come segue:

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

KsDevice

[in] Oggetto KSDEVICE che rappresenta il dispositivo gestito da KS.

Occupato

[in] Indica se attivare o disinnestare il raffreddamento attivo. Se TRUE, il driver deve attivare il raffreddamento attivo (ad esempio, attivando la ventola). Se FALSE, il driver deve disattivare il raffreddamento attivo (ad esempio, disattivando la ventola).

DeviceTermalState

[out] Valore restituito: stato termico determinato da Avstream. Se lo stato modifica la pipeline riceve una notifica della modifica. La pipeline invia una notifica a qualsiasi app registrata per le notifiche termiche.

PassiveCooling

Notifica di callback termica passiva.

La routine è definita come segue:

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

KsDevice

[in] Oggetto KSDEVICE che rappresenta il dispositivo gestito da KS.

Percentuale

[in] Percentuale di prestazioni complete in cui il dispositivo è autorizzato a funzionare. Un valore del parametro 100 indica che il dispositivo non è sottoposto a restrizioni di raffreddamento e può funzionare a livello di prestazioni completo. Un valore di parametro pari a zero indica che il dispositivo deve operare al livello termico più basso. Un valore di parametro compreso tra 0 e 100 indica il grado di limitazione delle prestazioni del dispositivo per ridurre la generazione di calore. Questo valore di parametro è una soglia che il dispositivo non deve superare.

DeviceTermalState

[out] Valore restituito: stato termico determinato da Avstream. Se lo stato modifica la pipeline riceve una notifica della modifica. La pipeline invia una notifica a qualsiasi app registrata per le notifiche termiche.

Fabbisogno

Requisito Valore
intestazione ks.h (include Ks.h)