WdfDeviceAssignSxWakeSettings-Funktion (wdfdevice.h)

Artikel
03/01/2024

[Gilt für KMDF und UMDF]

Die WdfDeviceAssignSxWakeSettings-Methode stellt vom Treiber bereitgestellte Informationen über die Fähigkeit eines Geräts bereit, ein Aktivierungssignal auszulösen, während sich das Gerät und das System in einem Energiesparzustand befinden.

Syntax

NTSTATUS WdfDeviceAssignSxWakeSettings(
  [in] WDFDEVICE                              Device,
  [in] PWDF_DEVICE_POWER_POLICY_WAKE_SETTINGS Settings
);

Parameter

[in] Device

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

[in] Settings

Ein Zeiger auf eine vom Aufrufer bereitgestellte WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS-Struktur .

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceAssignSxWakeSettings STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_DEVICE_REQUEST	Der aufrufende Treiber ist nicht der Besitzer der Energierichtlinie des Geräts.
STATUS_INVALID_PARAMETER	Ein ungültiger Einstellungswert wird erkannt.
STATUS_INFO_LENGTH_MISMATCH	Die Größe der WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS-Struktur ist falsch.
STATUS_POWER_STATE_INVALID	Der Bustreiber gibt an, dass das Gerät kein Aktivierungssignal auslösen kann, oder die WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS-Struktur enthält einen ungültigen Gerätestromzustand.

Die -Methode gibt möglicherweise andere NTSTATUS-Werte zurück.

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

Hinweise

Weitere Informationen finden Sie unter Unterstützung der Systemreaktivierung.

Beispiele

Im folgenden Codebeispiel wird eine WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS-Struktur initialisiert und dann WdfDeviceAssignSxWakeSettings aufgerufen. Im Beispiel werden die Standardeinstellungen verwendet, die WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT festlegen.

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS  wakeSettings;
NTSTATUS  status = STATUS_SUCCESS;

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT(&wakeSettings);

status = WdfDeviceAssignSxWakeSettings(
                                       device,
                                       &wakeSettings
                                       );
if (!NT_SUCCESS(status)) {
    return status;
}

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), FDOPowerPolicyOwnerAPI(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NonFDONotPowerPolicyOwnerAPI(kmdf)

Weitere Informationen

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS

WdfDeviceAssignS0IdleSettings

Freigeben über