Funzione FltIsIoRedirectionAllowedForOperation (fltkernel.h)

Articolo
02/26/2024

La routine FltIsIoRedirectionAllowedForOperation determina se l'I/O può essere reindirizzato dall'istanza del filtro associata alla struttura di FLT_CALLBACK_DATA specificata all'istanza del filtro specificata.

Sintassi

NTSTATUS FLTAPI FltIsIoRedirectionAllowedForOperation(
  [in]            PFLT_CALLBACK_DATA Data,
  [in]            PFLT_INSTANCE      TargetInstance,
  [out]           PBOOLEAN           RedirectionAllowedThisIo,
  [out, optional] PBOOLEAN           RedirectionAllowedAllIo
);

Parametri

[in] Data

Struttura FLT_CALLBACK_DATA che rappresenta l'operazione di I/O.

[in] TargetInstance

Istanza di filtro nello stack di dispositivi di destinazione.

[out] RedirectionAllowedThisIo

Valore TRUE se questo I/O può essere reindirizzato allo stack di dispositivi di destinazione modificando l'istanza del filtro a cui si fa riferimento.

[out, optional] RedirectionAllowedAllIo

Questo parametro facoltativo ha un valore TRUE se tutte le operazioni di I/O nello stack di dispositivi in cui viene eseguita l'operazione di I/O possono essere reindirizzate al dispositivo di destinazione modificando l'istanza del filtro a cui viene fatto riferimento, altrimenti FALSE.

Valore restituito

Valore NTSTATUS di STATUS_SUCCESS per esito positivo o STATUS_NOT_SUPPORTED se il reindirizzamento non è supportato.

Commenti

Un'operazione di I/O è associata a una struttura FLT_CALLBACK_DATA . Tale struttura contiene un riferimento a un oggetto PFLT_IO_PARAMETER_BLOCK , che contiene un riferimento alla FLT_INSTANCE del minifiltro associato all'operazione di I/O.

Se RedirectionAllowed è TRUE, il minifilter può reindirizzare le operazioni di I/O modificando tale istanza in una nuova istanza di destinazione.

Se RedirectionAllowed è FALSE, il minifilter deve allocare un nuovo oggetto dati di callback per emettere I/O nello stack di destinazione o chiamare FltAdjustDeviceStackSizeForIoRedirection per aumentare le dimensioni dello stack di dispositivi di origine.

Nota I minifiltri non devono modificare il riferimento al FLT_INSTANCE prima di verificare che il reindirizzamento possa essere eseguito in questo modo. Usare FltIsIoRedirectionAllowedForOperation o FltIsIoRedirectionAllowed.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (include FltKernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<=DISPATCH_LEVEL

Vedi anche

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowed

Condividi tramite