Partager via


PO_FX_DIRECTED_POWER_UP_CALLBACK fonction de rappel (wdm.h)

La fonction de rappel PO_FX_DIRECTED_POWER_UP_CALLBACK est implémentée par le pilote client pour gérer les activités d’alimentation spécifiques au pilote pour le compte de DFx (Dirigé 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 une utilisation ultérieure.

Valeur de retour

Aucun

Remarques

Les pilotes WDM qui s’inscrivent auprès de PoFx pour la prise en charge de la gestion de l’alimentation inactive du runtime 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 hors 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 alimenté lorsque le système quitte la veille moderne, les activateurs commencer à s’exécuter, ou un réveil initié 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 alimenter l’appareil.

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

  • Débloquer des files d’attente d’E/S et commencer à 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, même si aucun S-IRP n’est impliqué.

Notez que si une hiérarchie d’appareils est impliquée, le framework d’alimentation dirigé demande aux appareils enfants de se 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 de pouvoir sont pris en compte.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1903
d’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