Fonction WdfDeviceIndicateWakeStatus (wdfdevice.h)

Article
02/27/2024

[S’applique uniquement à KMDF]

La méthode WdfDeviceIndicateWakeStatus informe l’infrastructure que le pilote de bus appelant a cessé d’attendre qu’un appareil spécifié déclenche un signal de veille sur le bus.

Syntaxe

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

[in] WaitWakeStatus

Valeur de status NTSTATUS. Si l’appareil a déclenché un signal de veille, l’appelant doit définir cette valeur sur STATUS_SUCCESS ou une autre valeur status pour laquelle NT_SUCCESS(WaitWakeStatus) est égal à TRUE. Si l’appareil n’a pas déclenché de signal de veille ou si une erreur a été détectée, l’appelant doit fournir une valeur status pour laquelle NT_SUCCESS(WaitWakeStatus) est FALSE. Pour plus d'informations, consultez la section Notes qui suit.

Valeur retournée

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

Code de retour	Description
STATUS_INVALID_PARAMETER	WaitWakeStatus est STATUS_PENDING ou STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST	La pile de pilotes n’a pas été configurée pour attendre que l’appareil déclenche un signal de veille.
STATUS_INVALID_DEVICE_STATE	Le pilote appelant n’est pas responsable d’attendre que l’appareil déclenche un signal de veille.

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

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Si NT_SUCCESS(WaitWakeStatus) est égal à TRUE, l’infrastructure restaure l’appareil et le système à leurs états de fonctionnement. Si NT_SUCCESS(WaitWakeStatus) est égal à FALSE, l’appareil et le système restent dans leur état actuel.

Pour plus d’informations sur l’appel de la méthode WdfDeviceIndicateWakeStatus , consultez Prise en charge de l’éveil du système.

Exemples

L’exemple de code suivant informe l’infrastructure que l’appareil spécifié a déclenché un signal de veille.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfdevice.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partager via