Funzione PoFxSetComponentWake (wdm.h)

La routine PoFxSetComponentWake indica se il driver esegue la riattivazione del componente specificato ogni volta che il componente entra nella condizione inattiva.

Sintassi

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

Parametri

[in] Handle

Handle che rappresenta la registrazione del dispositivo con il framework di risparmio energia (PoFx). Il driver di dispositivo ha ricevuto in precedenza questo handle dalla routine PoFxRegisterDevice .

[in] Component

Indice che identifica il componente. Questo parametro è un indice nella matrice Components nella struttura PO_FX_DEVICE utilizzata dal driver del dispositivo per registrare il dispositivo con PoFx. Se la matrice Components contiene elementi N, gli indici dei componenti sono compresi tra 0 e N-1.

[in] WakeHint

Indica se il driver esegue la riattivazione del componente ogni volta che il componente entra nella condizione inattiva. Se TRUE, il driver arma il componente da riattivare. Se FALSE, il driver non armerà il componente da riattivare.

Valore restituito

nessuno

Osservazioni

Prima che un componente entri in uno stato fx a bassa potenza, il driver potrebbe armere il componente per riattivare automaticamente un segnale di input da un'origine esterna, ad esempio se l'utente preme un pulsante. Il parametro WakeHint informa PoFx se il driver esegue la riattivazione del componente. Se un componente è armato per riattivare, PoFx non commuterà il componente in uno stato fx a bassa potenza da cui il componente non può riattivarsi.

Quando un dispositivo è registrato con PoFx, le informazioni di registrazione per ogni componente nel dispositivo sono contenute in una struttura di PO_FX_COMPONENT separata. Il membro DeepestWakeableIdleState di questa struttura specifica lo stato fx più profondo da cui il componente può riattivarsi.

Il driver del dispositivo può chiamare PoFxSetComponentWake ogni volta che una modifica delle condizioni richiede una modifica nel valore WakeHint . Dopo ogni chiamata, il nuovo valore WakeHint rimane effettivo finché il driver chiama PoFxSetComponentWake per aggiornarlo.

Se un componente si trova nella condizione inattiva quando viene chiamato PoFxSetComponentWake, PoFx potrebbe modificare lo stato fx del componente per supportare il nuovo valore del parametro WakeHint specificato dal chiamante.

Requisiti

Vedi anche

PO_FX_COMPONENT