Fonction WdfDeviceIndicateWakeStatus (wdfdevice.h)
[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 |
---|---|
|
WaitWakeStatus est STATUS_PENDING ou STATUS_CANCELLED. |
|
La pile de pilotes n’a pas été configurée pour attendre que l’appareil déclenche un signal de veille. |
|
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) |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour