!irp

A extensão !irp mostra informações sobre um pacote de solicitação de E/S (IRP).

!irp Address [Detail] 

Parâmetros

Endereço
Especifica o endereço hexadecimal do IRP.

Detalhe
Se esse parâmetro for incluído com qualquer valor, como 1, a saída incluirá o status do IRP, o endereço da sua lista de descritores de memória (MDL), seu thread proprietário e informações de pilha para todas as pilhas de E/S e informações sobre cada local de pilha para o IRP, incluindo versões hexadecimais do código de função principal e do código de função secundária. Se esse parâmetro for omitido, a saída incluirá somente um resumo das informações.

DLL

Kdexts.dll

Informações Adicionais

Consulte Depuração Plug and Play e Depuração Interrupt Storms para aplicativos deste comando de extensão. Para obter informações sobre IRPs, confira a documentação do Kit de Driver do Windows (WDK) e o livro Microsoft Windows Internals de Mark Russinovich e David Solomon. Para mais informações sobre os códigos de função principais e secundários, consulte a documentação do Kit de Driver do Windows (WDK).

Este tópico descreve a estrutura IRP, IRP.

Para obter informações detalhadas sobre como decodificar a estrutura IRP, incluindo Args retornados, consulte os recursos a seguir.

• Windows Internals de Mark E. Russinovich, David A. Solomon e Alex Ionescu
• Como desenvolver drivers com o Windows Driver Foundation Guy Smith e Penny Orwick

Comentários

A saída também indica em quais condições a rotina de conclusão para cada local de pilha será chamada depois que o IRP for concluído e o local da pilha for processado. Há três possibilidades:

Êxito
Indica que a rotina de conclusão vai ser chamada quando o IRP for concluído com um código de êxito.

Erro
Indica que a rotina de conclusão vai ser chamada quando o IRP for concluído com um código de erro.

Cancelar
Indica que a rotina de conclusão vai ser chamada se uma tentativa tiver sido feita para cancelar o IRP.

Qualquer combinação desses três pode aparecer, e se alguma das condições exibidas for satisfeitas, a rotina de conclusão será chamada. Os valores apropriados são listados no final da primeira linha de informações sobre cada local de pilha, imediatamente após a entrada Completion-Context.

Veja a seguir um exemplo da saída desta extensão do Windows 10:

0: kd> !irp ac598dc8
Irp is active with 2 stacks 1 is current (= 0xac598e38)
 No Mdl: No System Buffer: Thread 8d1c7bc0:  Irp stack trace.  
     cmd  flg cl Device   File     Completion-Context
>[IRP_MJ_FILE_SYSTEM_CONTROL(d), N/A(0)]
            1 e1 8a6434d8 ac598d40 853220cb-a89682d8 Success Error Cancel pending
           \FileSystem\Npfs fltmgr!FltpPassThroughCompletion
            Args: 00000000 00000000 00110008 00000000
 [IRP_MJ_FILE_SYSTEM_CONTROL(d), N/A(0)]
            1  0 8a799710 ac598d40 00000000-00000000    
           \FileSystem\FltMgr
            Args: 00000000 00000000 0x00110008 00000000

A partir do Windows 10, o texto do código principal e secundário do IRP aparece, por exemplo, "IRP_MJ_FILE_SYSTEM_CONTROL" O valor do código também aparece em hex, neste exemplo, "(d)".

O terceiro argumento mostrado na saída é o código IOCTL. Use o comando !ioctldecode para exibir informações sobre o IOCTL.

Veja a seguir um exemplo da saída dessa extensão do sistema Windows Vista.

0: kd> !irp 0x831f4a00
Irp is active with 8 stacks 5 is current (= 0x831f4b00)
 Mdl = 82b020d8 Thread 8c622118:  Irp stack trace.
     cmd  flg cl Device   File     Completion-Context
 [  0, 0]   0  0 00000000 00000000 00000000-00000000

                        Args: 00000000 00000000 00000000 00000000
 [  0, 0]   0  0 00000000 00000000 00000000-00000000

                        Args: 00000000 00000000 00000000 00000000
 [  0, 0]   0  0 00000000 00000000 00000000-00000000

                        Args: 00000000 00000000 00000000 00000000
 [  0, 0]   0  0 00000000 00000000 00000000-00000000

                        Args: 00000000 00000000 00000000 00000000
>[  3,34]  40 e1 828517a8 00000000 842511e0-00000000 Success Error Cancel pending
               \Driver\disk     partmgr!PmReadWriteCompletion
 Args: 00007000 00000000 fe084e00 00000004
 [  3, 0]  40 e0 82851450 00000000 842414d4-82956350 Success Error Cancel
 \Driver\PartMgr  volmgr!VmpReadWriteCompletionRoutine
                        Args: 129131bb 000000de fe084e00 00000004
 [  3, 0]   0 e0 82956298 00000000 847eeed0-829e2ba8 Success Error Cancel
 \Driver\volmgr   Ntfs!NtfsMasterIrpSyncCompletionRoutine
                        Args: 00007000 00000000 1bdae400 00000000
 [  3, 0]   0  0 82ac2020 8e879410 00000000-00000000
               \FileSystem\Ntfs
                        Args: 00007000 00000000 00018400 00000000

A rotina de conclusão ao lado do nome do driver é definida neste local de pilha e foi definida pelo driver na linha abaixo. No exemplo anterior, Ntfs!NtfsMasterIrpSyncCompletionRoutine foi definido por \FileSystem\Ntfs. A entrada Completion-Context acima de Ntfs!NtfsMasterIrpSyncCompletionRoutine, 847eeed0-829e2ba8 indica o endereço da rotina de conclusão, bem como o contexto que será passado para Ntfs!NtfsMasterIrpSyncCompletionRoutine. A partir disso, podemos ver que o endereço de Ntfs!NtfsMasterIrpSyncCompletionRoutine is 847eeed0 e o contexto que será passado para esta rotina quando ela for chamada é 829e2ba8.

Códigos de função principais do IRP

As informações a seguir estão incluídas para ajudar você a interpretar a saída desse comando de extensão.

Os códigos de função principais do IRP são estes:

Os códigos de função secundária do Plug and Play são estes:

Os códigos de função secundários do WMI são estes:

Os códigos de função secundária de gerenciamento de energia são estes:

Os códigos de função secundária do SCSI são estes:

Confira também

IRP

!irpfind

!ioctldecode