PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK função de retorno de chamada (wdm.h)

  • Artigo

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)

Confira também

PO_FX_CORE_DEVICE