PO_FX_DIRECTED_POWER_UP_CALLBACK função de retorno de chamada (wdm.h)
A função de retorno de chamada PO_FX_DIRECTED_POWER_UP_CALLBACK é implementada pelo driver cliente para lidar com atividades de ativação específicas do driver em nome do DFx (PoFx).
Sintaxe
PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;
void PoFxDirectedPowerUpCallback(
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 quando o sistema determina que o dispositivo precisa ligar depois de ter sido desligado anteriormente na função de retorno de chamada PO_FX_DIRECTED_POWER_DOWN_CALLBACK. O dispositivo pode precisar ser ativado quando o sistema sair de Espera Moderna, ativadores começar a ser executado ou ocorrer uma ativação iniciada por hardware.
Quando esse retorno de chamada é invocado, o driver normalmente executa as seguintes tarefas de alto nível:
Solicite um IRP D0 para ativar o dispositivo.
Depois que o IRP D0 for concluído, chame PoFxReportDevicePoweredOn.
Desbloqueie filas de E/S e inicie o processamento de solicitações normalmente.
Depois que o driver concluir a chamada de ativação direcionada, ele poderá retomar o comportamento rtd3 (runtime-ocioso).
O contrato é muito semelhante ao S0, embora nenhum S-IRPs esteja envolvido.
Observe que, 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