Funzione IoAllocateIrp (wdm.h)

Articolo
03/08/2023

La routine IoAllocateIrp alloca un'IRP , dato il numero di posizioni dello stack di I/O per ogni driver a livelli sotto il chiamante e, facoltativamente, per il chiamante. Vedere anche IoAllocateIrpEx.

Sintassi

PIRP IoAllocateIrp(
  [in] CCHAR   StackSize,
  [in] BOOLEAN ChargeQuota
);

Parametri

[in] StackSize

Specifica il numero di posizioni dello stack di I/O da allocare per l'IRP. Questo valore deve essere almeno uguale a StackSize dell'oggetto dispositivo del driver inferiore successivo, ma può essere uno maggiore di questo valore. Il driver chiamante non deve allocare una posizione dello stack nell'IRP stessa.

[in] ChargeQuota

Se si imposta su TRUE , la memoria allocata per l'IRP deve essere addebitata rispetto alla quota per il processo corrente. Deve essere impostato su FALSE per driver intermedi. Questa opzione può essere impostata 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.

Valore restituito

IoAllocateIrp restituisce un puntatore a un'istanza di IRP, allocata dallo spazio di sistema non di pagina o NULL se non è stato possibile allocare un'istanza di IRP.

Commenti

La routine IoAllocateIrp non associa l'IRP a un thread. Il driver di allocazione deve liberare l'IRP anziché completarlo al gestore di I/O.

Un driver intermedio o di livello più alto può chiamare IoAllocateIrp per creare irP per le richieste inviate ai driver di livello inferiore. Tale driver deve inizializzare l'IRP e deve impostare la routine IoCompletion nell'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 uso. È possibile usare IoInitializeIrp per riutilizzare un'IRP già usata in determinate circostanze speciali. Per informazioni dettagliate, vedere Riutilizzo di IRP .

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 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	ForwardedAtBadIrqlAllocate(wdm), HwStorPortProhibitedDDIs(storport), IoAllocateComplete(wdm), IoAllocateForward(wdm), IoAllocateFree(wdm), IoAllocateIrpSignalEventInCompletion(wdm), IoAllocateIrpSignalEventInCompletion2 (wdm), IoAllocateIrpSignalEventInCompletion3(wdm), IoAllocatecaterpSignalEventInCompletionTimeout(wdm), IoFreeIrp(storport), IoReuseIrp(wdm), MarkPower(wdm), MarkPowerDown(wdm), MarkQueryRelations(wdm), MarkStartDevice(wdm), SpNoWait(storport), StorPortStartIo(storport)