PO_FX_DIRECTED_POWER_UP_CALLBACK fonction de rappel (wdm.h)

  • Article

La fonction de rappel PO_FX_DIRECTED_POWER_UP_CALLBACK est implémentée par le pilote client pour gérer les activités de mise sous tension spécifiques au pilote pour le compte de DFx ( Direct PoFx).

Syntaxe

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

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

Paramètres

Context

Fournit un pointeur vers le contexte passé à PoFxRegisterDevice.

Flags

Réservé pour un usage futur.

Valeur de retour

None

Remarques

Les pilotes WDM qui s’inscrivent auprès de PoFx pour la prise en charge de la gestion de l’alimentation inactive de l’exécution doivent implémenter ce rappel pour ajouter la prise en charge de DFx.

Inscrivez votre implémentation de cette fonction de rappel en définissant le membre approprié de la structure PO_FX_DEVICE_V3 , puis en appelant PoFxRegisterDevice.

Ce rappel est appelé lorsque le système détermine que l’appareil doit être mis sous tension après avoir été précédemment mis hors tension dans la fonction de rappel PO_FX_DIRECTED_POWER_DOWN_CALLBACK . L’appareil peut avoir besoin d’être mis sous tension lorsque le système quitte la veille moderne, que les activateurs commencent à s’exécuter ou qu’une sortie de veille déclenchée par le matériel se produit.

Lorsque ce rappel est appelé, le pilote effectue généralement les tâches générales suivantes :

  • Demandez un IRP D0 pour mettre l’appareil sous tension.

  • Une fois l’IRP D0 terminée, appelez PoFxReportDevicePoweredOn.

  • Débloquez les files d’attente d’E/S et commencez à traiter les demandes normalement.

Une fois que le pilote a terminé l’appel de mise sous tension dirigé, il peut reprendre le comportement d’inactivité du runtime (RTD3).

Le contrat est très similaire à S0, bien qu’aucun S-IRP ne soit impliqué.

Notez que si une hiérarchie d’appareils est impliquée, l’infrastructure d’alimentation dirigée demande aux appareils enfants de mettre hors tension avant l’appareil parent. Pour un appareil parent donné, les enfants directs (ceux énumérés par le parent) et les enfants indirects en raison de relations d’alimentation sont pris en compte.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 version 1903
En-tête wdm.h (include Wdm.h)

Voir aussi

Présentation de l’infrastructure de gestion de l’alimentation dirigée

PO_FX_DIRECTED_POWER_DOWN_CALLBACK