PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK funzione di callback (wdm.h)
La routine di callback ComponentCriticalTransitionCallback gestisce una transizione del componente specificato tra gli stati di alimentazione F0 (completamente attiva) e F a basso consumox.
Sintassi
PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;
void PoFxComponentCriticalTransitionCallback(
[in] PVOID Context,
[in] ULONG Component,
[in] BOOLEAN Active
)
{...}
Parametri
[in] Context
Puntatore al contesto del dispositivo. Il driver di dispositivo usa questo contesto per archiviare informazioni sullo stato di alimentazione corrente del dispositivo. Questo contesto è definito dal driver ed è opaco per PoFx. Il driver ha specificato questo puntatore nel membro DeviceContext della struttura PO_FX_CORE_DEVICE utilizzata dal driver per registrare il dispositivo con il framework di risparmio energia di Windows (PoFx).
[in] Component
Indice che identifica il componente. Questo parametro è un indice nella matrice componenti nella struttura PO_FX_CORE_DEVICE usata dal driver di dispositivo per registrare il dispositivo con PoFx. Se la matrice Components contiene N elementi, gli indici dei componenti sono compresi tra 0 e N-1.
[in] Active
Indica se questa notifica è per una transizione allo stato di alimentazione del componente F0. Se TRUE, il componente ha appena completato una transizione da uno stato F a basso consumox a F0. Se FALSE, il componente sta per avviare una transizione da F0 a uno stato F a basso consumox.
Valore restituito
Nessuno
Osservazioni
Questa routine di callback viene implementata da un driver di dispositivo e viene chiamata da PoFx. PoFx chiama questa routine per notificare al driver le transizioni di alimentazione dei componenti del dispositivo.
Il membro ComponentCriticalTransitionCallback della struttura PO_FX_CORE_DEVICE è un puntatore a un ComponentCriticalTransitionCallback routine di callback. Un puntatore a una struttura PO_FX_CORE_DEVICE viene passato come parametro di input nella chiamata PoFxRegisterCoreDevice che registra un dispositivo core con windows framework di risparmio energia (PoFx).
Per gestire le chiamate a questa routine, il driver di dispositivo salva o ripristina lo stato del registro o altro contesto hardware del componente specificato nel dispositivo.
Se Active = TRUE, PoFx ha chiamato questa routine dopo il componente ha completato una transizione da uno stato Fx a F0 a basso consumo. In questa chiamata, la routine ripristina il contesto hardware salvato in precedenza del componente.
Se Active = FALSE, PoFx ha chiamato questa routine prima che il componente avvii una transizione in sospeso da F0 a uno stato F a basso consumox. In questa chiamata, la routine salva il contesto hardware del componente in modo che questo contesto possa essere ripristinato in un secondo momento.
Per altre informazioni sugli stati di alimentazione dei componenti Fx, vedere Component-Level Power Management.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 10. |
| piattaforma di destinazione | Finestre |
| intestazione | wdm.h (include Wudfwdm.h) |