Função PoFxSetComponentWake (wdm.h)
A rotina PoFxSetComponentWake indica se o driver arma o componente especificado para ativar sempre que o componente entra na condição ociosa.
Sintaxe
void PoFxSetComponentWake(
[in] POHANDLE Handle,
[in] ULONG Component,
[in] BOOLEAN WakeHint
);
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 .
[in] Component
O índice que identifica o componente. Esse parâmetro é um índice na matriz Components na estrutura PO_FX_DEVICE que o driver de dispositivo usou para registrar o dispositivo com PoFx. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N-1.
[in] WakeHint
Se o driver armar o componente para ativar sempre que o componente entrar na condição ociosa. Se TRUE, o driver arma o componente para ativar. Se FALSE, o driver não armará o componente para ativar.
Retornar valor
Nenhum
Comentários
Antes que um componente insira um estado Fx de baixa potência, o driver pode armar o componente para ativar automaticamente em resposta a um sinal de entrada de uma fonte externa (por exemplo, se o usuário pressionar um botão). O parâmetro WakeHint informa a PoFx se o driver arma o componente para ativar. Se um componente estiver armado para ativar, o PoFx não alternará o componente para um estado Fx de baixa potência do qual o componente não pode ativar.
Quando um dispositivo é registrado com PoFx, as informações de registro de cada componente no dispositivo estão contidas em uma estrutura PO_FX_COMPONENT separada. O membro DeepestWakeableIdleState dessa estrutura especifica o estado fx mais profundo do qual o componente pode ser ativado.
O driver do dispositivo pode chamar PoFxSetComponentWake sempre que uma alteração nas condições exigir uma alteração no valor WakeHint . Após cada chamada, o novo valor WakeHint permanece em vigor até que o driver chame PoFxSetComponentWake novamente para atualizá-lo.
Se um componente estiver na condição ociosa quando PoFxSetComponentWake for chamado, PoFx poderá alterar o estado fx do componente para acomodar o novo valor de parâmetro WakeHint especificado pelo chamador.
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 |