Macro WdfDeviceStopIdleWithTag (wdfdevice.h)
[S’applique à KMDF et UMDF]
La macro WdfDeviceStopIdleWithTag incrémente le nombre de références d’alimentation pour un objet d’appareil framework spécifié et affecte le nom de fichier actuel et le numéro de ligne du pilote à la référence. La macro affecte également une valeur d’étiquette à la référence.
Syntaxe
NTSTATUS WdfDeviceStopIdleWithTag(
_In_ WDFDEVICE Device,
_In_ BOOLEAN WaitForD0,
_In_ PVOID Tag
);
Paramètres
[in] Device
Handle d’un objet d’appareil framework.
[in] WaitForD0
Valeur booléenne qui indique quand WdfDeviceStopIdleWithTag sera retourné. Si la valeur est TRUE, elle retourne uniquement une fois que l’appareil spécifié a entré l’état d’alimentation de l’appareil D0. Si la valeur est FALSE, la méthode retourne immédiatement.
[in] Tag
Valeur définie par le pilote que l’infrastructure stocke en tant que balise d’identification pour la référence d’alimentation.
Valeur de retour
None
Remarques
Si l’opération réussit, WdfDeviceStopIdleWithTag retourne STATUS_SUCCESS.
Les valeurs de retour supplémentaires sont les suivantes :
| Code de retour | Description |
|---|---|
| STATUS_PENDING | L’appareil est mis sous tension de manière asynchrone. |
| STATUS_INVALID_DEVICE_STATE | Le pilote n’est pas le propriétaire de la stratégie d’alimentation de l’appareil. |
| STATUS_POWER_STATE_INVALID | Une défaillance de l’appareil s’est produite et l’appareil ne peut pas entrer dans son état d’alimentation D0. |
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.
Si votre pilote appelle WdfDeviceStopIdleWithTag pour incrémenter un nombre de références, le pilote doit appeler WdfDeviceResumeIdleWithTag pour décrémenter le nombre.
L’appel de WdfDeviceStopIdleWithTag au lieu de WdfDeviceStopIdle fournit des informations supplémentaires (valeur de balise, numéro de ligne et nom de fichier) que vous pouvez afficher dans les débogueurs Microsoft. WdfDeviceStopIdleWithTag utilise le numéro de ligne et le nom de fichier actuels du pilote.
Vous pouvez afficher les valeurs de balise, de numéro de ligne et de nom de fichier à l’aide de l’extension de débogueur !wdftagtracker . L’extension de débogueur affiche la valeur de balise sous la forme d’un pointeur et d’une série de caractères.
Utilisez !wdfkd.wdfdevice avec des indicateurs détaillés sur et localisez le lien vers !wdftagtracker dans la sortie :
kd> !wdfdevice <handle> f
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.15 |
| Version UMDF minimale | 2.15 |
| En-tête | wdfdevice.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | Consultez la section Notes. |
| Règles de conformité DDI | DriverCreate, KmdfIrql, KmdfIrql2 |