Funzione FltVetoBypassIo (fltkernel.h)
FltVetoBypassIo recupera le informazioni necessarie per veto una richiesta BypassIO.
Sintassi
NTSTATUS FLTAPI FltVetoBypassIo(
[in] PFLT_CALLBACK_DATA CallbackData,
[in] PCFLT_RELATED_OBJECTS FltObjects,
[in] NTSTATUS OperationStatus,
[in] PCUNICODE_STRING FailureReason
);
Parametri
[in] CallbackData
Puntatore al FLT_CALLBACK_DATA per FSCTL_MANAGE_BYPASS_IO.
[in] FltObjects
Puntatore alla struttura FLT_RELATED_OBJECTS per l'operazione BypassIO.
[in] OperationStatus
Codice di errore NTSTATUS fornito dal filtro per il veto.
[in] FailureReason
Stringa univoca e descrittiva che fornisce dettagli sul motivo per cui il filtro sta vetando la richiesta di abilitazione BypassIO.
Valore restituito
FltVetoBypassIo restituisce STATUS_SUCCESS al completamento positivo; in caso contrario, restituisce un valore NTSTATUS, ad esempio uno dei seguenti.
Valore | Significato |
---|---|
STATUS_BUFFER_TOO_SMALL | Il buffer di output DI FSCTL è troppo piccolo. |
STATUS_INVALID_BUFFER_SIZE | Il buffer di input DI FSCTL è troppo piccolo. |
STATUS_INVALID_PARAMETER_3 | Non è stato fornito un codice di errore appropriato. |
STATUS_INVALID_PARAMETER_4 | Non è stato fornito un motivo di errore appropriato. |
STATUS_NOT_SUPPORTED | L'operazione richiesta non è supportata o non è stata richiesta da un callback pre-op. |
Commenti
Un minifilter chiama FltVetoBypassIo quando intende veto un FS_BPIO_OP_ENABLE o FS_BPIO_OP_QUERY richiesta in un file. Un minifilter deve chiamare questa routine solo dal callback di pre-operazione.
FltVetoBypassIo riempie la struttura di FS_BPIO_OUTPUT allocata dal chiamante associata a CallbackData con le informazioni necessarie per veto della richiesta BypassIO. Il chiamante deve fornire un buffer sufficiente per contenere la struttura.
FltVetoBypassIo registra un evento ETW con lo stato, il motivo fornito dal filtro e il nome del filtro.
Per altre informazioni , vedere BypassIO per i driver di filtro e supporto delle operazioni bypassIO .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 11 |
Intestazione | fltkernel.h |
IRQL | <= APC_LEVEL |