!ruleinfo

  • Artigo

O comando !ruleinfo exibe informações sobre uma regra do Verificador de Driver.

!ruleinfo RuleId [RuleState [SubState]]

Parâmetros

Regra
A ID da regra do verificador. Este é o primeiro argumento da verificação de bug DRIVER_VERIFIER_DETECTED_VIOLATION.

Estado de regra
Informações de estado adicionais sobre a violação. Este é o terceiro argumento da verificação de bug DRIVER_VERIFIER_DETECTED_VIOLATION.

Sub-Estado
Informações de subestado sobre a violação. Este é o quarto argumento da verificação de bug DRIVER_VERIFIER_DETECTED_VIOLATION.

DLL

ext.dll

Comentários

Esse comando aplica-se somente a regras na extensão do Verificador de Driver; ou seja, regras que tenham uma ID maior ou igual a 0x10000.

O exemplo a seguir mostra os quatro argumentos de uma verificação de bug 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
...

Na saída anterior, a ID da regra (0x91001) é mostrada como Arg1. Arg3 e Arg4 são os endereços das informações de estado e subestado da regra. Você pode passar a ID da regra, o estado da regra e o subestado para !ruleinfo a fim de obter uma descrição da regra e um link para a documentação detalhada da regra.

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://video2.skills-academy.com/windows-hardware/drivers/devtest/ndis-ndisoidcomplete

CONTEXT: Miniport 0xFFFFE0000283F1A0

CURRENT_TIME (Timed Rules): 142 seconds

RULE_STATE: 0xFFFFE000027B83F8