Función IoAllocateIrpEx (wdm.h)

Artículo
03/05/2024

IoAllocateIrpEx asigna un IRP del grupo no paginado del sistema, posiblemente con una extensión IRP.

Sintaxis

PIRP IoAllocateIrpEx(
  PDEVICE_OBJECT DeviceObject,
  CCHAR          StackSize,
  BOOLEAN        ChargeQuota
);

Parámetros

DeviceObject

Puntero al objeto de dispositivo que se va a comprobar para determinar si se va a agregar espacio para una extensión IRP. Cuando DeviceObject se establece en DEVICE_WITH_IRP_EXTENSION, también se asigna espacio para la extensión IRP.

StackSize

Número máximo de ubicaciones de pila que se van a asignar para el IRP. StackSize debe ser al menos igual que StackSize del objeto de dispositivo del controlador inferior siguiente, pero puede ser uno mayor que este valor. El controlador de llamada no necesita asignar una ubicación de pila en el IRP por sí mismo.

ChargeQuota

Al establecer ChargeQuota en TRUE , la memoria asignada para el IRP se cargará con la cuota del proceso actual. Este parámetro solo se puede establecer en TRUE por los controladores de nivel superior a los que se llama en el contexto del subproceso que origina la solicitud de E/S para la que el controlador asigna otro IRP. Los controladores intermedios deben establecer este parámetro en FALSE.

Valor devuelto

IoAllocateIrpEx devuelve un puntero al IRP asignado e inicializado, o NULL si no se pudo asignar un IRP.

Comentarios

IoAllocateIrpEx asigna ubicaciones de pila StackSize e inicializa el IRP. No asocia el IRP a un subproceso. El controlador de asignación debe liberar el IRP en lugar de volver a completarlo en el administrador de E/S.

Un controlador intermedio o de nivel superior puede llamar a IoAllocateIrpEx para crear IRP para las solicitudes que envía a los controladores de nivel inferior. Este controlador debe inicializar el IRP y debe establecer su rutina de devolución de llamada de IoCompletion en el IRP que crea para que el autor de la llamada pueda eliminar el IRP cuando los controladores de nivel inferior hayan completado el procesamiento de la solicitud. IoAllocateIrp inicializa automáticamente los miembros del IRP. No use IoInitializeIrp para inicializar el IRP antes de su primer uso. (Puede usar IoInitializeIrp para reutilizar un IRP que ya haya usado en determinadas circunstancias especiales. Consulte Reutilización de IRP para obtener más información). Un controlador intermedio o de nivel superior también puede llamar a IoBuildDeviceIoControlRequest, IoBuildAsynchronousFsdRequest o IoBuildSynchronousFsdRequest para configurar las solicitudes que envía a controladores de nivel inferior. Solo un controlador de nivel superior puede llamar a IoMakeAssociatedIrp.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 10 (versión 1507)
Plataforma de destino	Universal
Encabezado	wdm.h (include wdm.h, ntddk.h, ntifs.h)
Library	ntoskrnl.lib
Archivo DLL	ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL