Funzione KsForwardIrp (ks.h)

La funzione KsForwardIrp inoltra un'IRP al driver specificato dopo aver inizializzato il percorso dello stack successivo e impostando l'oggetto file.

Sintassi

KSDDKAPI NTSTATUS KsForwardIrp(
  [in] PIRP         Irp,
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      ReuseStackLocation
);

Parametri

[in] Irp

Specifica l'IRP inoltrato al driver specificato.

[in] FileObject

Specifica l'oggetto file con cui inizializzare lo stack successivo.

[in] ReuseStackLocation

Specifica la nuova posizione dello stack.

Valore restituito

La funzione KsForwardIrp restituisce il risultato di IoCallDriver oppure restituisce uno stato non valido se non è disponibile alcuna profondità dello stack.

Commenti

Usare la funzione KsForwardIrp quando viene modificato solo il parametro FileObject dell'IRP inoltrato quando i parametri dello stack corrente vengono copiati nel percorso dello stack successivo. La funzione verifica che sia presente una nuova posizione dello stack da copiare prima di tentare di copiare. Se non esiste una nuova posizione dello stack, l'IRP viene completato con STATUS_INVALID_DEVICE_REQUEST.

Requisiti