Função PoFxStartDevicePowerManagement (wdm.h)

  • Artigo

A rotina PoFxStartDevicePowerManagement conclui o registro de um dispositivo com a PoFx (estrutura de gerenciamento de energia) e inicia o gerenciamento de energia do dispositivo.

Sintaxe

void PoFxStartDevicePowerManagement(
  [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 do dispositivo recebeu esse identificador anteriormente da rotina PoFxRegisterDevice .

Retornar valor

Nenhum

Comentários

Depois que um driver chama a rotina PoFxRegisterDevice para registrar um dispositivo com PoFx, todos os componentes no dispositivo estão totalmente ativados e na condição ativa para que o driver possa concluir a inicialização do hardware. Para iniciar o gerenciamento ativo de energia, o driver deve chamar PoFxStartDevicePowerManagement. Por padrão, essa chamada alterna todos os componentes para a condição ociosa.

Depois que PoFxStartDevicePowerManagement alternar um componente para a condição ociosa, o PoFx poderá começar imediatamente a chamar as rotinas de retorno de chamada do driver, mesmo antes de PoFxStartDevicePowerManagement retornar. PoFx chama a rotina de retorno de chamada ComponentIdleConditionCallback do driver para indicar que um componente mudou para a condição ociosa. O driver não deve acessar um componente que esteja na condição ociosa. Antes que o driver possa acessar o componente, o driver deve chamar o PoFxActivateComponent e aguardar poFx chamar a rotina de retorno de chamada ComponentActiveConditionCallback do driver. Esse retorno de chamada informa ao driver que o componente está na condição ativa e pode ser acessado com segurança.

Se o driver exigir que um componente esteja na condição ativa imediatamente após o início do gerenciamento de energia, o driver deverá ativar explicitamente o componente chamando a rotina PoFxActivateComponent , e essa chamada deve ocorrer após a chamada PoFxRegisterDevice , mas antes da chamada PoFxStartDevicePowerManagement .

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 PASSIVE_LEVEL

Confira também

ComponentActiveConditionCallback

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice