WdfDeviceAssignSxWakeSettings, fonction (wdfdevice.h)

[S’applique à KMDF et UMDF]

La méthode WdfDeviceAssignSxWakeSettings fournit des informations fournies par le pilote sur la capacité d’un appareil à déclencher un signal de veille alors que l’appareil et le système sont dans un état à faible alimentation.

Syntaxe

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

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] Settings

Pointeur vers une structure de WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS fournie par l’appelant.

Valeur de retour

Si l’opération réussit, WdfDeviceAssignSxWakeSettings retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

La méthode peut retourner d’autres valeurs NTSTATUS .

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations, consultez prise en charge dude mise en éveil du système.

Exemples

L’exemple de code suivant initialise une structure WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS, puis appelle WdfDeviceAssignSxWakeSettings. L’exemple utilise les paramètres par défaut qui WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT jeux.

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

Exigences

Voir aussi

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS

WdfDeviceAssignS0IdleSettings