KSDEVICE_THERMAL_DISPATCH struttura (ks.h)

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 delle funzioni di callback per interfacce di raffreddamento attivo e passivo.

Sintassi

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

Members

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 KSS.

Impegnati

[in] Indica se coinvolgere o annullare il raffreddamento attivo. Se TRUE, il driver deve coinvolgere 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 termica determinato da Avstream. Se lo stato modifica la pipeline viene notificata la modifica. La pipeline 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 KSS.

Percentuale

[in] Percentuale di prestazioni complete a cui è consentito il funzionamento del dispositivo. Un valore di 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 funzionare al livello di temperatura più basso. Un valore di parametro compreso tra 0 e 100 indica il grado in cui è necessario limitare le 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 termica determinato da Avstream. Se lo stato modifica la pipeline viene notificata la modifica. La pipeline notifica a qualsiasi app registrata per le notifiche termiche.

Requisiti

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