Funzione WdfDeviceAssignSxWakeSettings (wdfdevice.h)

Articolo
03/05/2024

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceAssignSxWakeSettings fornisce informazioni fornite dal driver sulla capacità di un dispositivo di attivare un segnale di riattivazione mentre sia il dispositivo che il sistema si trovano in uno stato di bassa potenza.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] Settings

Puntatore a una struttura di WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS fornita dal chiamante.

Valore restituito

Se l'operazione ha esito positivo, WdfDeviceAssignSxWakeSettings restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il driver chiamante non è il proprietario del criterio di alimentazione del dispositivo.
STATUS_INVALID_PARAMETER	Viene rilevato un valore Impostazioni non valido.
STATUS_INFO_LENGTH_MISMATCH	Le dimensioni della struttura WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS non sono corrette.
STATUS_POWER_STATE_INVALID	Il driver del bus indica che il dispositivo non può attivare un segnale di riattivazione o la struttura WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS contiene uno stato di alimentazione del dispositivo non valido.

Il metodo potrebbe restituire altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Per altre informazioni, vedere Supporto della riattivazione del sistema.

Esempio

L'esempio di codice seguente inizializza una struttura WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS e quindi chiama WdfDeviceAssignSxWakeSettings. Nell'esempio vengono usate le impostazioni predefinite impostate WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT .

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), FDOPowerPolicyOwnerAPI(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NonFDONotPowerPolicyOwnerAPI(kmdf)

Vedi anche

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS

WdfDeviceAssignS0IdleSettings

Condividi tramite