Estrutura IRP (wdm.h)
A estrutura IRP é uma estrutura parcialmente opaca que representa um pacote de solicitação de E/S. Os membros não documentados da estrutura IRP são reservados, usados apenas pelo gerente de E/S ou, em alguns casos, por FSDs (drivers do sistema de arquivos).
Sintaxe
typedef struct _IRP {
CSHORT Type;
USHORT Size;
PMDL MdlAddress;
ULONG Flags;
union {
struct _IRP *MasterIrp;
__volatile LONG IrpCount;
PVOID SystemBuffer;
} AssociatedIrp;
LIST_ENTRY ThreadListEntry;
IO_STATUS_BLOCK IoStatus;
KPROCESSOR_MODE RequestorMode;
BOOLEAN PendingReturned;
CHAR StackCount;
CHAR CurrentLocation;
BOOLEAN Cancel;
KIRQL CancelIrql;
CCHAR ApcEnvironment;
UCHAR AllocationFlags;
union {
PIO_STATUS_BLOCK UserIosb;
PVOID IoRingContext;
};
PKEVENT UserEvent;
union {
struct {
union {
PIO_APC_ROUTINE UserApcRoutine;
PVOID IssuingProcess;
};
union {
PVOID UserApcContext;
#if ...
_IORING_OBJECT *IoRing;
#else
struct _IORING_OBJECT *IoRing;
#endif
};
} AsynchronousParameters;
LARGE_INTEGER AllocationSize;
} Overlay;
__volatile PDRIVER_CANCEL CancelRoutine;
PVOID UserBuffer;
union {
struct {
union {
KDEVICE_QUEUE_ENTRY DeviceQueueEntry;
struct {
PVOID DriverContext[4];
};
};
PETHREAD Thread;
PCHAR AuxiliaryBuffer;
struct {
LIST_ENTRY ListEntry;
union {
struct _IO_STACK_LOCATION *CurrentStackLocation;
ULONG PacketType;
};
};
PFILE_OBJECT OriginalFileObject;
} Overlay;
KAPC Apc;
PVOID CompletionKey;
} Tail;
} IRP;
Membros
Type
Reservado para uso interno do sistema.
Size
Reservado para uso interno do sistema.
MdlAddress
Ponteiro para um MDL que descreve um buffer de usuário, se o driver estiver usando E/S direta e o código de função principal do IRP for um dos seguintes:
IRP_MJ_READ
O MDL descreve um buffer vazio que o dispositivo ou o driver preenche.
IRP_MJ_WRITE
O MDL descreve um buffer que contém dados para o dispositivo ou driver.
IRP_MJ_DEVICE_CONTROL ou IRP_MJ_INTERNAL_DEVICE_CONTROL
Se o código IOCTL especificar o tipo de transferência METHOD_IN_DIRECT, o MDL descreverá um buffer que contém dados para o dispositivo ou driver.
Se o código IOCTL especificar o tipo de transferência METHOD_OUT_DIRECT, o MDL descreverá um buffer vazio que o dispositivo ou driver preenche.
Para obter mais informações sobre os buffers associados a tipos de transferência de METHOD_IN_DIRECT e METHOD_OUT_DIRECT em códigos IOCTL, consulte Descrições de buffer para códigos de controle de E/S.
Se o driver não estiver usando E/S direta, esse ponteiro será NULL.
Flags
Os drivers do sistema de arquivos usam esse campo, que é somente leitura para todos os drivers. Os drivers de dispositivo de rede e, possivelmente, de nível mais alto também podem ler esse campo. Esse campo é definido como zero ou como bit a bit-OR de um ou mais dos seguintes bits de sinalizador definidos pelo sistema:
- IRP_NOCACHE
- IRP_PAGING_IO
- IRP_MOUNT_COMPLETION
- IRP_SYNCHRONOUS_API
- IRP_ASSOCIATED_IRP
- IRP_BUFFERED_IO
- IRP_DEALLOCATE_BUFFER
- IRP_INPUT_OPERATION
- IRP_SYNCHRONOUS_PAGING_IO
- IRP_CREATE_OPERATION
- IRP_READ_OPERATION
- IRP_WRITE_OPERATION
- IRP_CLOSE_OPERATION
- IRP_DEFER_IO_COMPLETION
- IRP_OB_QUERY_NAME
- IRP_HOLD_DEVICE_QUEUE
- IRP_UM_DRIVER_INITIATED_IO
AssociatedIrp
Reservado para uso interno do sistema.
AssociatedIrp.MasterIrp
Ponteiro para a master IRP em um IRP que foi criado por uma chamada de driver de nível mais alto para IoMakeAssociatedIrp.
AssociatedIrp.IrpCount
Reservado para uso interno do sistema.
AssociatedIrp.SystemBuffer
Ponteiro para um buffer de espaço do sistema.
Se o driver estiver usando E/S em buffer, a finalidade do buffer será determinada pelo código de função principal do IRP, da seguinte maneira:
SystemBuffer.IRP_MJ_READ
O buffer recebe dados do dispositivo ou driver. O comprimento do buffer é especificado por Parameters.Read.Length na estrutura de IO_STACK_LOCATION do driver.
SystemBuffer.IRP_MJ_WRITE
O buffer fornece dados para o dispositivo ou driver. O comprimento do buffer é especificado por Parameters.Write.Length na estrutura IO_STACK_LOCATION do driver.
SystemBuffer.IRP_MJ_DEVICE_CONTROL ou IRP_MJ_INTERNAL_DEVICE_CONTROL
O buffer representa os buffers de entrada e saída fornecidos para DeviceIoControl e IoBuildDeviceIoControlRequest. Os dados de saída substituem os dados de entrada.
Para entrada, o comprimento do buffer é especificado por Parameters.DeviceIoControl.InputBufferLength na estrutura IO_STACK_LOCATION do driver.
Para saída, o comprimento do buffer é especificado por Parameters.DeviceIoControl.OutputBufferLength na estrutura IO_STACK_LOCATION do driver.
Para obter mais informações, consulte Descrições de buffer para códigos de controle de E/S.
O buffer representa o buffer de entrada fornecido para DeviceIoControl e IoBuildDeviceIoControlRequest.
O comprimento do buffer é especificado por Parameters.DeviceIoControl.InputBufferLength na estrutura IO_STACK_LOCATION do driver.
Para obter mais informações, consulte Descrições de buffer para códigos de controle de E/S.
Se o driver estiver usando E/S direta, a finalidade do buffer será determinada pelo código de função principal do IRP, da seguinte maneira:
ThreadListEntry
Reservado para uso interno do sistema.
IoStatus
Contém a estrutura IO_STATUS_BLOCK na qual um driver armazena status e informações antes de chamar IoCompleteRequest.
RequestorMode
Indica o modo de execução do solicitante original da operação, um de UserMode ou KernelMode.
PendingReturned
Se definido como TRUE, um driver marcou o IRP pendente. Cada rotina IoCompletion deve marcar o valor desse sinalizador. Se o sinalizador for TRUE e se a rotina IoCompletion não retornar STATUS_MORE_PROCESSING_REQUIRED, a rotina deverá chamar IoMarkIrpPending para propagar o status pendente para drivers acima dele na pilha do dispositivo.
StackCount
Reservado para uso interno do sistema.
CurrentLocation
Reservado para uso interno do sistema.
Cancel
Se definido como TRUE, o IRP será ou deverá ser cancelado.
CancelIrql
Contém o IRQL no qual um driver está em execução quando IoAcquireCancelSpinLock é chamado.
ApcEnvironment
Reservado para uso interno do sistema.
AllocationFlags
Reservado para uso interno do sistema.
UserIosb
Reservado para uso interno do sistema.
IoRingContext
Reservado para uso interno do sistema.
UserEvent
Reservado para uso interno do sistema.
Overlay
Reservado para uso interno do sistema.
Overlay.AsynchronousParameters
Reservado para uso interno do sistema.
Overlay.AsynchronousParameters.UserApcRoutine
Reservado para uso interno do sistema.
Overlay.AsynchronousParameters.IssuingProcess
Reservado para uso interno do sistema.
Overlay.AsynchronousParameters.UserApcContext
Reservado para uso interno do sistema.
Overlay.AsynchronousParameters.IoRing
Reservado para uso interno do sistema.
Overlay.AllocationSize
Reservado para uso interno do sistema.
CancelRoutine
Contém o ponto de entrada para uma rotina cancelar fornecida pelo driver a ser chamada se o IRP for cancelado. NULL indica que o IRP não pode ser cancelado no momento.
UserBuffer
Contém o endereço de um buffer de saída se ambas as seguintes condições se aplicarem:
O código de função principal no local da pilha de E/S é IRP_MJ_DEVICE_CONTROL ou IRP_MJ_INTERNAL_DEVICE_CONTROL.
O código de controle de E/S foi definido com METHOD_NEITHER ou METHOD_BUFFERED.
Para METHOD_BUFFERED, o driver deve usar o buffer apontado por Irp-AssociatedIrp.SystemBuffer> como o buffer de saída. Quando o driver conclui a solicitação, o gerenciador de E/S copia o conteúdo desse buffer para o buffer de saída apontado por Irp-UserBuffer>. O driver não deve gravar diretamente no buffer apontado por Irp-UserBuffer>. Para obter mais informações, consulte Descrições de buffer para códigos de controle de E/S.
Tail
Reservado para uso interno do sistema.
Tail.Overlay
Reservado para uso interno do sistema.
Tail.Overlay.DeviceQueueEntry
Se os IRPs estiverem na fila do dispositivo associado ao objeto de dispositivo do driver, esse campo vinculará IRPs na fila do dispositivo. Esses links só podem ser usados enquanto o driver está processando o IRP.
Tail.Overlay.DriverContext[4]
Se os IRPs não estiverem na fila do dispositivo associada ao objeto de dispositivo do driver, esse campo poderá ser usado pelo driver para armazenar até quatro ponteiros. Esse campo só pode ser usado enquanto o driver possui o IRP.
Tail.Overlay.Thread
Um ponteiro para o TCB (bloco de controle de thread) do chamador. Para solicitações originadas no modo de usuário, o gerenciador de E/S sempre define esse campo para apontar para o TCB do thread que emitiu a solicitação.
Tail.Overlay.AuxiliaryBuffer
Reservado para uso interno do sistema.
Tail.Overlay.ListEntry
Se um driver gerencia suas próprias filas internas de IRPs, ele usa esse campo para vincular um IRP ao próximo. Esses links só podem ser usados enquanto o driver mantém o IRP em sua fila ou está processando o IRP.
Tail.Overlay.CurrentStackLocation
Reservado para uso interno do sistema.
Tail.Overlay.PacketType
Reservado para uso interno do sistema.
Tail.Overlay.OriginalFileObject
Reservado para uso interno do sistema.
Tail.Apc
Reservado para uso interno do sistema.
Tail.CompletionKey
Reservado para uso interno do sistema.
Comentários
Os membros não documentados da estrutura IRP são reservados, usados apenas pelo gerenciador de E/S ou, em alguns casos, por FSDs (drivers do sistema de arquivos).
Um IRP é a estrutura básica do gerenciador de E/S usada para se comunicar com drivers e permitir que os drivers se comuniquem entre si. Um pacote consiste em duas partes diferentes:
Cabeçalho ou parte fixa do pacote – isso é usado pelo gerenciador de E/S para armazenar informações sobre a solicitação original, como os parâmetros independentes do dispositivo do chamador, o endereço do objeto do dispositivo no qual um arquivo está aberto e assim por diante. Ele também é usado por drivers para armazenar informações como o status final da solicitação.
Locais de pilha de E/S — Seguindo o cabeçalho está um conjunto de locais de pilha de E/S, um por driver na cadeia de drivers em camadas para o qual a solicitação está associada. Cada local de pilha contém os parâmetros, os códigos de função e o contexto usados pelo driver correspondente para determinar o que ele deveria estar fazendo. Para obter mais informações, consulte a estrutura IO_STACK_LOCATION .
Embora um driver de nível superior possa marcar o valor do Boolean Cancel em um IRP, esse driver não pode assumir que o IRP será concluído com STATUS_CANCELLED por um driver de nível inferior, mesmo que o valor seja TRUE.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de