PO_FX_DIRECTED_POWER_DOWN_CALLBACK funzione di callback (wdm.h)

La funzione di callback PO_FX_DIRECTED_POWER_DOWN_CALLBACK viene implementata dal driver client per gestire le attività di spegnimento specifiche del driver per conto di DFx (Directed PoFx).

Sintassi

PO_FX_DIRECTED_POWER_DOWN_CALLBACK PoFxDirectedPowerDownCallback;

void PoFxDirectedPowerDownCallback(
  PVOID Context,
  ULONG Flags
)
{...}

Parametri

Context

Fornisce un puntatore al contesto passato a PoFxRegisterDevice.

Flags

Riservato per utilizzi futuri.

Valore restituito

nessuno

Osservazioni

I driver WDM che si registrano con PoFx per il supporto di risparmio energia inattivo di runtime devono implementare questo callback per aggiungere il supporto DFx.

Registrare l'implementazione di questa funzione di callback impostando il membro appropriato della struttura PO_FX_DEVICE_V3 e quindi chiamando PoFxRegisterDevice.

Questo callback viene richiamato durante una sessione di standby moderno quando questo dispositivo o dipendente da questo dispositivo ha bloccato la voce DRIPS per almeno due minuti consecutivi (timeout configurabile dal driver, valore predefinito di 2 minuti) senza alcuna attività software negoziata attivatrice in esecuzione.

Quando viene richiamato questo callback, il driver esegue in genere le attività generali seguenti:

• Interrompere l'elaborazione di un nuovo lavoro.

• Passare immediatamente allo stato a basso consumo.

• Rimanere in stato a basso consumo fino a quando il sistema non chiama il PO_FX_DIRECTED_POWER_UP_CALLBACK del driver.

I passaggi e l'ordine di implementazione possono variare, ma potrebbero includere alcuni dei seguenti elementi:

• Richiedere un IRP Dx.

• Dopo l'arrivo dell'IRP Dx, bloccare le code di I/O.

• Attendere il completamento delle operazioni in corso.

• Se queste operazioni richiedono troppo tempo, annullarle facoltativamente.

• Eseguire azioni necessarie per eseguire la transizione del dispositivo a Dx (ad esempio, salvare lo stato hardware).

• Braccio per la riattivazione in base alle esigenze.

• Chiama PoFxCompleteDirectedPowerDown.

• Rimanere in Dx fino a quando il sistema non chiama PO_FX_DIRECTED_POWER_UP_CALLBACK.

Il contratto è molto simile a S3/S4, anche se non sono coinvolti S-IRP.

Se è coinvolta una gerarchia di dispositivi, il framework di alimentazione diretta chiede ai dispositivi figlio di spegnere prima del dispositivo padre. Per un determinato dispositivo padre, vengono considerati figli diretti (enumerati dal padre) e figli indiretti a causa delle relazioni di potere .

Requisiti

Vedi anche

Introduzione a Directed Power Management Framework

PO_FX_DIRECTED_POWER_UP_CALLBACK