WdfDeviceSetPowerCapabilities-Funktion (wdfdevice.h)

  • Artikel

[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:

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