PO_FX_DIRECTED_POWER_UP_CALLBACK funzione di callback (wdm.h)

  • Articolo

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

Sintassi

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  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 inattivi di runtime devono implementare questo callback per aggiungere il supporto di 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 quando il sistema determina la necessità di attivare il dispositivo dopo aver eseguito in precedenza l'alimentazione nella funzione di callback PO_FX_DIRECTED_POWER_DOWN_CALLBACK. Il dispositivo potrebbe essere attivato quando il sistema chiude Modern Standby, gli attivatori iniziano a essere eseguiti o si verifica una riattivazione avviata dall'hardware.

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

  • Richiedere un'IRP D0 per attivare il dispositivo.

  • Al termine dell'IRP D0, chiamare PoFxReportDevicePoweredOn.

  • Sbloccare le code di I/O e avviare normalmente le richieste di elaborazione.

Al termine della chiamata di alimentazione diretta, il driver può riprendere il comportamento di runtime inattivo (RTD3).

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

Si noti che 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, i figli diretti (quelli enumerati dall'elemento padre) e i figli indiretti a causa delle relazioni di potere vengono considerati.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1903
Intestazione wdm.h (include Wdm.h)

Vedi anche

Introduzione al framework di Gestione energia diretta

PO_FX_DIRECTED_POWER_DOWN_CALLBACK