!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:
| Códigos de função principais | Código hexadecimal |
|---|---|
IRP_MJ_CREATE |
0x00 |
IRP_MJ_CREATE_NAMED_PIPE |
0x01 |
IRP_MJ_CLOSE |
0x02 |
IRP_MJ_READ |
0x03 |
IRP_MJ_WRITE |
0x04 |
IRP_MJ_QUERY_INFORMATION |
0x05 |
IRP_MJ_SET_INFORMATION |
0x06 |
IRP_MJ_QUERY_EA |
0x07 |
IRP_MJ_SET_EA |
0x08 |
IRP_MJ_FLUSH_BUFFERS |
0x09 |
IRP_MJ_QUERY_VOLUME_INFORMATION |
0x0A |
IRP_MJ_SET_VOLUME_INFORMATION |
0x0B |
IRP_MJ_DIRECTORY_CONTROL |
0x0C |
IRP_MJ_FILE_SYSTEM_CONTROL |
0x0D |
IRP_MJ_DEVICE_CONTROL |
0x0E |
| IRP_MJ_INTERNAL_DEVICE_CONTROL IRP_MJ_SCSI | 0x0F |
IRP_MJ_SHUTDOWN |
0x10 |
IRP_MJ_LOCK_CONTROL |
0x11 |
IRP_MJ_CLEANUP |
0x12 |
IRP_MJ_CREATE_MAILSLOT |
0x13 |
IRP_MJ_QUERY_SECURITY |
0x14 |
IRP_MJ_SET_SECURITY |
0x15 |
IRP_MJ_POWER |
0x16 |
IRP_MJ_SYSTEM_CONTROL |
0x17 |
IRP_MJ_DEVICE_CHANGE |
0x18 |
IRP_MJ_QUERY_QUOTA |
0x19 |
IRP_MJ_SET_QUOTA |
0x1A |
| IRP_MJ_PNP IRP_MJ_MAXIMUM_FUNCTION | 0x1B |
Os códigos de função secundária do Plug and Play são estes:
| Código de função secundária | Código hexadecimal |
|---|---|
IRP_MN_START_DEVICE |
0x00 |
IRP_MN_QUERY_REMOVE_DEVICE |
0x01 |
IRP_MN_REMOVE_DEVICE |
0x02 |
IRP_MN_CANCEL_REMOVE_DEVICE |
0x03 |
IRP_MN_STOP_DEVICE |
0x04 |
IRP_MN_QUERY_STOP_DEVICE |
0x05 |
IRP_MN_CANCEL_STOP_DEVICE |
0x06 |
IRP_MN_QUERY_DEVICE_RELATIONS |
0x07 |
IRP_MN_QUERY_INTERFACE |
0x08 |
IRP_MN_QUERY_CAPABILITIES |
0x09 |
IRP_MN_QUERY_RESOURCES |
0x0A |
IRP_MN_QUERY_RESOURCE_REQUIREMENTS |
0x0B |
IRP_MN_QUERY_DEVICE_TEXT |
0x0C |
IRP_MN_FILTER_RESOURCE_REQUIREMENTS |
0x0D |
IRP_MN_READ_CONFIG |
0x0F |
IRP_MN_WRITE_CONFIG |
0x10 |
IRP_MN_EJECT |
0x11 |
IRP_MN_SET_LOCK |
0x12 |
IRP_MN_QUERY_ID |
0x13 |
IRP_MN_QUERY_PNP_DEVICE_STATE |
0x14 |
IRP_MN_QUERY_BUS_INFORMATION |
0x15 |
IRP_MN_DEVICE_USAGE_NOTIFICATION |
0x16 |
IRP_MN_SURPRISE_REMOVAL |
0x17 |
IRP_MN_QUERY_LEGACY_BUS_INFORMATION |
0x18 |
Os códigos de função secundários do WMI são estes:
| Código de função secundária | Código hexadecimal |
|---|---|
IRP_MN_QUERY_ALL_DATA |
0x00 |
IRP_MN_QUERY_SINGLE_INSTANCE |
0x01 |
IRP_MN_CHANGE_SINGLE_INSTANCE |
0x02 |
IRP_MN_CHANGE_SINGLE_ITEM |
0x03 |
IRP_MN_ENABLE_EVENTS |
0x04 |
IRP_MN_DISABLE_EVENTS |
0x05 |
IRP_MN_ENABLE_COLLECTION |
0x06 |
IRP_MN_DISABLE_COLLECTION |
0x07 |
IRP_MN_REGINFO |
0x08 |
IRP_MN_EXECUTE_METHOD |
0x09 |
Os códigos de função secundária de gerenciamento de energia são estes:
| Código de função secundária | Código hexadecimal |
|---|---|
IRP_MN_WAIT_WAKE |
0x00 |
IRP_MN_POWER_SEQUENCE |
0x01 |
IRP_MN_SET_POWER |
0x02 |
IRP_MN_QUERY_POWER |
0x03 |
Os códigos de função secundária do SCSI são estes:
| Código de função secundária | Código hexadecimal |
|---|---|
IRP_MN_SCSI_CLASS |
0x01 |