Função PoFxReportDevicePoweredOn (wdm.h)

  • Artigo

A rotina PoFxReportDevicePoweredOn notifica a PoFx (estrutura de gerenciamento de energia) de que o dispositivo concluiu a transição solicitada para o estado de energia D0 (totalmente ativado).

Sintaxe

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

Parâmetros

[in] Handle

Um identificador que representa o registro do dispositivo com a PoFx (estrutura de gerenciamento de energia). O driver de dispositivo recebeu anteriormente esse identificador da rotina PoFxRegisterDevice .

Retornar valor

Nenhum

Comentários

O driver de um dispositivo registrado deve chamar PoFxReportDevicePoweredOn após qualquer uma das seguintes ocorrências:

  • O PoFx chama a rotina de retorno de chamada DevicePowerRequiredCallback do driver para notificar o driver de que o dispositivo deve entrar no estado de energia D0.
  • O PoFx chama a rotina de retorno de chamada DirectedPowerUpCallback do driver para notificar o driver de que o dispositivo deve entrar no estado de energia D0.
  • A PoFx envia ao driver um IRP S0 (uma solicitação de IRP_MN_SET_POWER ) para notificar o driver de uma transição de sistema pendente para o estado de energia S0.
Em resposta a qualquer ocorrência, o driver envia d0 IRP (uma solicitação de IRP_MN_SET_POWER ) para baixo em sua pilha de dispositivos para iniciar uma transição para o estado de energia D0, se o dispositivo ainda não estiver no estado D0. Depois que o driver concluir (e todos os drivers inferiores forem concluídos) a transição para o estado D0, o driver chamará PoFxReportDevicePoweredOn para notificar PoFx.

O driver deve chamar PoFxReportDevicePoweredOn independentemente de nenhum IRP D0 ser necessário, a solicitação D0 IRP falhar, o IRP D0 despachado for bem-sucedido ou falhar ou se o IRP S0 for bem-sucedido ou falhar.

Para o retorno de chamada de energia necessário/direcionado, a chamada PoFxReportDevicePoweredOn pode ocorrer durante ou após a chamada de retorno de chamada.

Para uma solicitação IRP S0, o driver deve concluir essa solicitação assim que possível, alternar o dispositivo para o estado de energia D0 e chamar PoFxReportDevicePoweredOn. Para obter mais informações, consulte Manipulando um sistema Set-Power IRP em um proprietário de política de energia do dispositivo.

Na entrada para PoFxReportDevicePoweredOn, o dispositivo pode estar em um estado de energia D0 não inicializado no qual todos os componentes do dispositivo estão ativados. Em resposta à chamada PoFxReportDevicePoweredOn , o PoFx configura o dispositivo em um estado D0 inicializado. Durante essa configuração, a PoFx alterna o máximo de componentes possível para estados de energia fx de baixa potência.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho wdm.h
Biblioteca Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

Confira também

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice