Funzione IoCopyCurrentIrpStackLocationToNext (wdm.h)

Articolo
02/29/2024

La routine IoCopyCurrentIrpStackLocationToNext copia i parametri dello stack IRP dalla posizione corrente dello stack di I/O al percorso dello stack dello stack successivo.

Sintassi

void IoCopyCurrentIrpStackLocationToNext(
  [in, out] PIRP Irp
);

Parametri

[in, out] Irp

Puntatore all'IRP.

Valore restituito

nessuno

Osservazioni

Un driver chiama IoCopyCurrentIrpStackLocationToNext per copiare i parametri IRP dalla posizione dello stack alla posizione dello stack del driver inferiore successivo.

Dopo aver chiamato questa routine, un driver imposta in genere una routine di completamento di I/O con IoSetCompletionRoutine prima di passare L'IRP al driver inferiore successivo con IoCallDriver. I driver che passano i parametri IRP ma non impostano una routine di completamento I/O devono chiamare IoSkipCurrentIrpStackLocation invece di questa routine.

Se il driver chiama IoSkipCurrentIrpStackLocation, prestare attenzione a non modificare la struttura IO_STACK_LOCATION in modo che possa influire involontariamente sul driver inferiore o sul comportamento del sistema rispetto a tale driver. In particolare, il driver non deve modificare l'unione dei parametri della struttura IO_STACK_LOCATION e non deve chiamare la routine IoMarkIrpPending.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<=DISPATCH_LEVEL