Partilhar via

estrutura KSDEVICE_THERMAL_DISPATCH (ks.h)

  • Artigo

A estrutura KSDEVICE_THERMAL_DISPATCH é usada pelo driver de miniporto na chamada à API para registrar retornos de chamada de notificação térmica. Essa estrutura contém os ponteiros de função de retorno de chamada para interfaces de resfriamento ativas e passivas.

Sintaxe

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

Membros

ActiveCooling

A notificação de retorno de chamada térmica ativa.

A rotina é definida da seguinte maneira:

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

KsDevice

[in] Um objeto KSDEVICE que representa o dispositivo gerenciado pelo KS.

Noiva

[in] Indica se o resfriamento ativo deve ser ativado ou desengajado. Se TRUE, o driver deverá envolver o resfriamento ativo (por exemplo, ativando o ventilador). Se FALSE, o driver deverá desativar o resfriamento ativo (por exemplo, desativando o ventilador).

DeviceThermalState

[out] Valor retornado: estado térmico determinado por Avstream. Se o estado mudar, o pipeline será notificado sobre a alteração. O pipeline notifica qualquer aplicativo registrado para notificações térmicas.

PassiveCooling

A notificação de retorno de chamada térmica passiva.

A rotina é definida da seguinte maneira:

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

KsDevice

[in] Um objeto KSDEVICE que representa o dispositivo gerenciado pelo KS.

Porcentagem

[in] O percentual de desempenho completo no qual o dispositivo tem permissão para operar. Um valor de parâmetro de 100 indica que o dispositivo não está sob restrições de resfriamento e pode operar em nível de desempenho completo. Um valor de parâmetro igual a zero indica que o dispositivo deve operar no nível térmico mais baixo. Um valor de parâmetro entre 0 e 100 indica o grau em que o desempenho do dispositivo deve ser limitado para reduzir a geração de calor. Esse valor de parâmetro é um limite que o dispositivo não deve exceder.

DeviceThermalState

[out] Valor retornado: estado térmico determinado por Avstream. Se o estado mudar, o pipeline será notificado sobre a alteração. O pipeline notifica qualquer aplicativo registrado para notificações térmicas.

Requisitos

Requisito Valor
Cabeçalho ks.h (inclua Ks.h)