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

Confira também

PO_FX_COMPONENT