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 Fx a basso consumo.

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 di 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 a 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 Components 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 riguarda una transizione allo stato di alimentazione del componente F0. Se TRUE, il componente ha appena completato una transizione da uno stato Fx a basso consumo a F0. Se FALSE, il componente sta per avviare una transizione da F0 a uno stato Fx a basso consumo.

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 una routine di callback ComponentCriticalTransitionCallback . Un puntatore a una struttura PO_FX_CORE_DEVICE viene passato come parametro di input nella chiamata PoFxRegisterCoreDevice che registra un dispositivo principale con il framework di risparmio energia di Windows (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 che il componente ha completato una transizione da uno stato Fx a basso consumo a F0. 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 Fx a basso consumo. 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 Risparmio energia a livello di componente.

Requisiti

Vedi anche

PO_FX_CORE_DEVICE