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

  • Artigo

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 Direcionado).

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.

Retornar valor

Nenhum

Comentários

Os drivers WDM que se registram no PoFx para suporte ao gerenciamento de energia ociosa 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 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 . Talvez o dispositivo precise ser ativado quando o sistema sair do Modo de Espera Moderno, os ativadores começarem a ser executados 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 ligar o dispositivo.

  • Depois que o IRP D0 for concluído, chame PoFxReportDevicePoweredOn.

  • Desbloqueie filas de E/S e comece a processar solicitações normalmente.

Depois que o driver concluir a chamada de energia direcionada, ele poderá retomar o comportamento de RTD3 (runtime-idle).

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
Cliente mínimo com suporte Windows 10, versão 1903
Cabeçalho wdm.h (inclua Wdm.h)

Confira também

Introdução à estrutura de gerenciamento de energia direcionada

PO_FX_DIRECTED_POWER_DOWN_CALLBACK