PO_FX_DIRECTED_POWER_DOWN_CALLBACK função de retorno de chamada (wdm.h)
A função de retorno de chamada PO_FX_DIRECTED_POWER_DOWN_CALLBACK é implementada pelo driver cliente para lidar com atividades de power down específicas do driver em nome do DFx (de PoFx direcionado).
Sintaxe
PO_FX_DIRECTED_POWER_DOWN_CALLBACK PoFxDirectedPowerDownCallback;
void PoFxDirectedPowerDownCallback(
PVOID Context,
ULONG Flags
)
{...}
Parâmetros
Context
Fornece um ponteiro para o contexto passado para PoFxRegisterDevice.
Flags
Reservado para uso futuro.
Valor de retorno
Nenhum
Observações
Os drivers WDM que se registram no PoFx para suporte ao gerenciamento de energia ocioso de runtime precisam implementar esse retorno de chamada para adicionar suporte ao DFx.
Registre sua implementação dessa função de retorno de chamada definindo o membro apropriado da estrutura de PO_FX_DEVICE_V3 e chamando PoFxRegisterDevice.
Esse retorno de chamada é invocado durante uma sessão de Espera Moderna quando este dispositivo ou um dependente deste dispositivo bloqueou a entrada DRIPS por pelo menos dois minutos consecutivos (tempo limite configurável do driver, padrão de 2 minutos) sem nenhuma atividade de software intermediada pelo ativador em execução.
Quando esse retorno de chamada é invocado, o driver normalmente executa as seguintes tarefas de alto nível:
Pare de processar novos trabalhos.
Faça a transição para o estado de baixa potência imediatamente.
Permaneça em estado de baixa potência até que o sistema chame o PO_FX_DIRECTED_POWER_UP_CALLBACKdo driver.
As etapas de implementação e a ordem podem variar, mas podem incluir algumas das seguintes:
Solicite um Dx IRP.
Depois que o Dx IRP chegar, bloqueie as filas de E/S.
Aguarde a conclusão das operações em andamento.
Se essas operações estiverem demorando muito, opcionalmente cancele-as.
Execute as ações necessárias para fazer a transição do dispositivo para o Dx (por exemplo, salve o estado do hardware).
Armar para ativar conforme necessário.
Permaneça no Dx até que o sistema chame PO_FX_DIRECTED_POWER_UP_CALLBACK.
O contrato é muito semelhante ao S3/S4, embora nenhum S-IRPs esteja envolvido.
Se uma hierarquia de dispositivo estiver envolvida, a estrutura de energia direcionada solicitará que os dispositivos filho desliguem antes do dispositivo pai. Para um determinado dispositivo pai, são considerados filhos diretos (enumerados pelo pai) e filhos indiretos devido a relações de energia.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1903 |
| cabeçalho | wdm.h (inclua Wdm.h) |
Consulte também
introdução à estrutura de gerenciamento de energia direcionada