WdfDeviceAssignSxWakeSettings-Funktion (wdfdevice.h)
[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 |
|---|---|
|
Der aufrufende Treiber ist nicht der Besitzer der Energierichtlinie des Geräts. |
|
Ein ungültiger Einstellungswert wird erkannt. |
|
Die Größe der WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS-Struktur ist falsch. |
|
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) |