Função PoFxStartDevicePowerManagement (wdm.h)
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