Freigeben über

WdfDeviceSetPowerCapabilities-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WdfDeviceSetPowerCapabilities Methode meldet die Leistungsfähigkeit eines Geräts.

Syntax

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

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] PowerCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_POWER_CAPABILITIES Struktur.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

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

Wenn mehrere Treiber im Treiberstapel des Geräts WdfDeviceSetPowerCapabilitiesaufgerufen werden, 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 anschließend WdfDeviceSetPowerCapabilitiesaufgerufen.

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- Universal
Minimale KMDF-Version 1.0
Mindest-UMDF-Version 2.0
Header- wdfdevice.h (einschließen Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL- <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WDF_DEVICE_POWER_CAPABILITIES

WDF_DEVICE_POWER_CAPABILITIES_INIT

WdfDeviceSetPnpCapabilities