Partager via

!ruleinfo

  • Article

La commande !ruleinfo affiche des informations sur une règle de vérification des pilotes.

!ruleinfo RuleId [RuleState [SubState]]

Paramètres

RuleId
Identifiant (ID) de la règle de vérificateur. Ceci est le premier argument du bug check DRIVER_VERIFIER_DETECTED_VIOLATION.

RuleState
Informations d’état supplémentaires sur la violation. Ceci est le troisième argument du bug check DRIVER_VERIFIER_DETECTED_VIOLATION.

Sous-État
Informations de sous-état sur la violation. Ceci est le quatrième argument du bug check DRIVER_VERIFIER_DETECTED_VIOLATION.

DLL

ext.dll

Notes

Cette commande s’applique uniquement aux règles dans l’extension de vérificateur de pilote ; c’est-à-dire, aux règles ayant un ID supérieur ou égal à 0x10000.

L’exemple suivant montre les quatre arguments d’un bug check DRIVER_VERIFIER_DETECTED_VIOLATION.

DRIVER_VERIFIER_DETECTED_VIOLATION (c4)
...
Arguments:
Arg1: 0000000000091001, ID of the 'NdisOidComplete' rule that was violated.
Arg2: fffff800002d49d0, A pointer to the string describing the violated rule condition.
Arg3: ffffe000027b8370, Address of internal rule state (second argument to !ruleinfo).
Arg4: ffffe000027b83f8, Address of supplemental states (third argument to !ruleinfo).

## Debugging Details:


DV_VIOLATED_CONDITION:  This OID should only be completed with NDIS_STATUS_NOT_ACCEPTED, 
                        NDIS_STATUS_SUCCESS, or NDIS_STATUS_PENDING.

DV_MSDN_LINK: https://go.microsoft.com/fwlink/p/?linkid=278802

DRIVER_OBJECT: ffffe0000277a2b0
...

STACK_TEXT:  
ffffd000`2118ff58 fffff803`4c83afa2 : 00000000`000000c4 00000000`00000001 ...
ffffd000`2118ff60 fffff803`4c83a8c0 : 00000000`00000003 00000000`00091001 ...
...

STACK_COMMAND:  kb

FOLLOWUP_NAME:  Xxxx

FAILURE_BUCKET_ID:  Xxxx
...

Dans la sortie précédente, l’ID de la règle (0x91001) est indiqué comme Arg1. Arg3 et Arg4 sont les adresses des informations d’état et de sous-état de la règle. Vous pouvez transmettre l’ID de la règle, l’état de la règle et le sous-état à !ruleinfo pour obtenir une description de la règle et un lien vers la documentation détaillée de la règle.

3: kd> !ruleinfo 0x91001 0xffffe000027b8370 0xffffe000027b83f8

RULE_ID: 0x91001

RULE_NAME: NdisOidComplete

RULE_DESCRIPTION: ""
This rule verifies if an NDIS miniport driver completes an OID correctly.
Check RULE_STATE for Oid ( use !ndiskd.oid ), which can be one of the following:
1) NULL,
2) Pending OID, or
3) Previous OID if no OID is pending.

MSDN_LINK: https://learn.microsoft.com/windows-hardware/drivers/devtest/ndis-ndisoidcomplete

CONTEXT: Miniport 0xFFFFE0000283F1A0

CURRENT_TIME (Timed Rules): 142 seconds

RULE_STATE: 0xFFFFE000027B83F8