Funzione IoAllocateIrpEx (wdm.h)

Articolo
08/08/2023

IoAllocateIrpEx alloca un IRP dal pool non di paging di sistema, possibilmente con un'estensione IRP.

Sintassi

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

Parametri

DeviceObject

Puntatore all'oggetto dispositivo per verificare se aggiungere spazio per un'estensione IRP. Quando DeviceObject è impostato su DEVICE_WITH_IRP_EXTENSION, viene allocato anche lo spazio per l'estensione IRP.

StackSize

Numero massimo di posizioni dello stack da allocare per IRP. StackSize deve essere almeno uguale a StackSize dell'oggetto dispositivo del driver inferiore successivo, ma può essere maggiore di questo valore. Il driver chiamante non deve allocare una posizione dello stack in IRP per se stessa.

ChargeQuota

Se si imposta ChargeQuota su TRUE , la memoria allocata per l'IRP viene addebitata in base alla quota per il processo corrente. Questo parametro può essere impostato su TRUE solo dai driver di livello più alto chiamati nel contesto del thread che ha origine la richiesta di I/O per cui il driver sta allocando un altro IRP. I driver intermedi devono impostare questo parametro su FALSE.

Valore restituito

IoAllocateIrpEx restituisce un puntatore all'IRP allocato e inizializzato oppure NULL se non è stato possibile allocare un IRP.

Commenti

IoAllocateIrpEx alloca le posizioni dello stack StackSize e inizializza l'IRP. Non associa l'IRP a un thread. Il driver di allocazione deve liberare l'IRP invece di completarlo al gestore di I/O.

Un driver intermedio o di livello più alto può chiamare IoAllocateIrpEx per creare irP per le richieste inviate ai driver di livello inferiore. Tale driver deve inizializzare l'IRP e deve impostare la routine di callback IoCompletion in IRP creata in modo che il chiamante possa eliminare l'IRP quando i driver di livello inferiore hanno completato l'elaborazione della richiesta. IoAllocateIrp inizializza automaticamente i membri di IRP. Non usare IoInitializeIrp per inizializzare l'IRP prima del primo utilizzo. È possibile usare IoInitializeIrp per riutilizzare un IRP già usato in determinate circostanze speciali. Per informazioni dettagliate, vedere Riutilizzo dei runtime di integrazione . Un driver intermedio o di livello più alto può anche chiamare IoBuildDeviceIoControlRequest, IoBuildAsynchronousFsdRequest o IoBuildSynchronousFsdRequest per configurare le richieste inviate ai driver di livello inferiore. Solo un driver di livello più alto può chiamare IoMakeAssociatedIrp.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 10 (versione 1507)
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include wdm.h, ntddk.h, ntifs.h)
Libreria	ntoskrnl.lib
DLL	ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL