PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK função de retorno de chamada (wdm.h)
O ComponentCriticalTransitionCallback rotina de retorno de chamada manipula uma transição do componente especificado entre os estados de energia F0 (totalmente ativado) e Fx de baixa potência.
Sintaxe
PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;
void PoFxComponentCriticalTransitionCallback(
[in] PVOID Context,
[in] ULONG Component,
[in] BOOLEAN Active
)
{...}
Parâmetros
[in] Context
Um ponteiro para o contexto do dispositivo. O driver do dispositivo usa esse contexto para armazenar informações sobre o estado de energia atual do dispositivo. Esse contexto é definido pelo driver e é opaco para PoFx. O driver especificou esse ponteiro no DeviceContext membro da estrutura de PO_FX_CORE_DEVICE que o driver usou para registrar o dispositivo no da estrutura de gerenciamento de energia do Windows (PoFx).
[in] Component
O índice que identifica o componente. Esse parâmetro é um índice na matriz componentes na estrutura PO_FX_CORE_DEVICE usada pelo driver de dispositivo para registrar o dispositivo com PoFx. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N–1.
[in] Active
Indica se essa notificação é para uma transição para o estado de energia do componente F0. Se TRUE, o componente acaba de concluir uma transição de um estado Fx de baixa potência para F0. Se FALSE, o componente está prestes a iniciar uma transição de F0 para um estado Fx de baixa potência.
Valor de retorno
Nenhum
Observações
Essa rotina de retorno de chamada é implementada por um driver de dispositivo e é chamada pela PoFx. A PoFx chama essa rotina para notificar o driver de transições de energia dos componentes do dispositivo.
O membro ComponentCriticalTransitionCallback da estrutura PO_FX_CORE_DEVICE é um ponteiro para uma rotina de retorno de chamada ComponentCriticalTransitionCallback. Um ponteiro para uma estrutura de PO_FX_CORE_DEVICE é passado como um parâmetro de entrada na chamada PoFxRegisterCoreDevice que registra um dispositivo principal com a estrutura de gerenciamento de energia do Windows (PoFx).
Para lidar com chamadas para essa rotina, o driver do dispositivo salva ou restaura o estado de registro ou outro contexto de hardware do componente especificado no dispositivo.
Se Active = TRUE, a PoFx chamou essa rotina de depois que o componente concluiu uma transição de um estado Fx de baixa potência para F0. Nesta chamada, a rotina restaura o contexto de hardware salvo anteriormente do componente.
Se Active = FALSE, a PoFx chamou essa rotina de antes de o componente iniciar uma transição pendente de F0 para um estado Fx de baixa potência. Nessa chamada, a rotina salva o contexto de hardware do componente para que esse contexto possa ser restaurado posteriormente.
Para obter mais informações sobre os estados de energia do componente Fx, consulte Component-Level power management.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 10. |
| da Plataforma de Destino | Windows |
| cabeçalho | wdm.h (inclua Wudfwdm.h) |