PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK função de retorno de chamada (wdm.h)
A rotina de retorno de chamada ComponentCriticalTransitionCallback manipula uma transição do componente especificado entre os estados de energia do componente 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 de 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 membro DeviceContext da estrutura PO_FX_CORE_DEVICE que o driver usou para registrar o dispositivo com a PoFx ( estrutura de gerenciamento de energia ) do Windows.
[in] Component
O índice que identifica o componente. Esse parâmetro é um índice na matriz Components na estrutura PO_FX_CORE_DEVICE que o driver de dispositivo usou para registrar o dispositivo com PoFx. Se a matriz Components 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 acabou 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.
Retornar valor
Nenhum
Comentários
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 PO_FX_CORE_DEVICE é passado como um parâmetro de entrada na chamada PoFxRegisterCoreDevice que registra um dispositivo principal com a PoFx ( estrutura de gerenciamento de energia ) do Windows.
Para lidar com chamadas para essa rotina, o driver de dispositivo salva ou restaura o estado de registro ou outro contexto de hardware do componente especificado no dispositivo.
Se Ativo = TRUE, PoFx chamou essa rotina depois que o componente concluiu uma transição de um estado Fx de baixa potência para F0. Nessa chamada, a rotina restaura o contexto de hardware salvo anteriormente do componente.
Se Ativo = FALSO, PoFx chamou essa rotina 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 Gerenciamento de energia no nível do componente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte a partir do Windows 10. |
| Plataforma de Destino | Windows |
| Cabeçalho | wdm.h (include Wudfwdm.h) |