WdfDeviceSetPowerCapabilities, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La méthode WdfDeviceSetPowerCapabilities signale les fonctionnalités d’alimentation d’un appareil.

Syntaxe

void WdfDeviceSetPowerCapabilities(
  [in] WDFDEVICE                      Device,
  [in] PWDF_DEVICE_POWER_CAPABILITIES PowerCapabilities
);

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] PowerCapabilities

Pointeur vers une structure WDF_DEVICE_POWER_CAPABILITIES allouée par le pilote.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Un pilote appelle généralement WdfDeviceSetPowerCapabilities à partir de l’une des fonctions de rappel suivantes :

EvtDriverDeviceAdd
EvtDevicePrepareHardware
EvtDeviceD0Entry (si la valeur du paramètre PreviousState est WdfPowerDeviceD3Final)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

Si plusieurs pilotes de la pile de pilotes de l’appareil appellent WdfDeviceSetPowerCapabilities, le gestionnaire de l’alimentation utilise les valeurs fournies par le pilote le plus élevé dans la pile.

Exemples

L’exemple de code suivant initialise une structure WDF_DEVICE_POWER_CAPABILITIES, puis appelle WdfDeviceSetPowerCapabilities.

WDF_DEVICE_POWER_CAPABILITIES powerCaps;

WDF_DEVICE_POWER_CAPABILITIES_INIT(&powerCaps);
powerCaps.DeviceD1 = WdfTrue;
powerCaps.WakeFromD1 = WdfTrue;
powerCaps.DeviceWake = PowerDeviceD1;
powerCaps.DeviceState[PowerSystemWorking] = PowerDeviceD1;
powerCaps.DeviceState[PowerSystemSleeping1] = PowerDeviceD1;
powerCaps.DeviceState[PowerSystemSleeping2] = PowerDeviceD2;
powerCaps.DeviceState[PowerSystemSleeping3] = PowerDeviceD2;
powerCaps.DeviceState[PowerSystemHibernate] = PowerDeviceD3;
powerCaps.DeviceState[PowerSystemShutdown] = PowerDeviceD3;

WdfDeviceSetPowerCapabilities(
                              device,
                              &powerCaps
                              );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_DEVICE_POWER_CAPABILITIES

WDF_DEVICE_POWER_CAPABILITIES_INIT

WdfDeviceSetPnpCapabilities

Partager via