Fonction WdfDeviceInitSetPowerInrush (wdfdevice.h)
[S’applique uniquement à KMDF]
La méthode WdfDeviceInitSetPowerInrush informe le gestionnaire d’alimentation que l’appareil spécifié nécessite un appel d’entrée de courant lorsqu’il démarre.
Syntaxe
void WdfDeviceInitSetPowerInrush(
[in] PWDFDEVICE_INIT DeviceInit
);
Paramètres
[in] DeviceInit
Pointeur fourni par l’appelant vers une structure WDFDEVICE_INIT .
Valeur de retour
None
Remarques
Pour éviter de surcharger l’alimentation du système, le système démarre les appareils qui nécessitent une prise de courant un par un.
Si votre pilote appelle WdfDeviceInitSetPowerInrush, le framework le rend non paginable pendant les transitions d’état d’alimentation et le pilote ne doit pas appeler WdfDeviceInitSetPowerPageable.
Votre pilote doit appeler WdfDeviceInitSetPowerInrush avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.
L’appel de WdfDeviceInitSetPowerInrush à partir d’un pilote de filtre n’a aucun effet. Pour les pilotes de filtre, l’infrastructure utilise le paramètre spécifié par le pilote inférieur suivant dans la pile de pilotes.
Exemples
L’exemple de code suivant informe le gestionnaire d’alimentation qu’un appareil a besoin d’une prise de courant lorsqu’il démarre.
WdfDeviceInitSetPowerInrush(DeviceInit);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfdevice.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |