WdfDeviceSetPowerCapabilities-Funktion (wdfdevice.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfDeviceSetPowerCapabilities-Methode meldet die Energiefunktionen eines Geräts.

Syntax

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] PowerCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_POWER_CAPABILITIES-Struktur .

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Ein Treiber ruft in der Regel WdfDeviceSetPowerCapabilities aus einer der folgenden Rückruffunktionen auf:

EvtDriverDeviceAdd
EvtDevicePrepareHardware
EvtDeviceD0Entry (wenn der Wert des PreviousState-ParametersWdfPowerDeviceD3Final ist)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

Wenn mehr als ein Treiber im Treiberstapel des Geräts WdfDeviceSetPowerCapabilities aufrufen, verwendet der Power Manager die Werte, die vom Treiber bereitgestellt werden, der am höchsten im Stapel ist.

Beispiele

Im folgenden Codebeispiel wird eine WDF_DEVICE_POWER_CAPABILITIES-Struktur initialisiert und dann WdfDeviceSetPowerCapabilities aufgerufen.

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
                              );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_DEVICE_POWER_CAPABILITIES

WDF_DEVICE_POWER_CAPABILITIES_INIT

WdfDeviceSetPnpCapabilities

Freigeben über