Função FltVetoBypassIo (fltkernel.h)

Artigo
03/01/2024

FltVetoBypassIo recupera as informações necessárias para vetar uma solicitação bypassIO.

Sintaxe

NTSTATUS FLTAPI FltVetoBypassIo(
  [in] PFLT_CALLBACK_DATA    CallbackData,
  [in] PCFLT_RELATED_OBJECTS FltObjects,
  [in] NTSTATUS              OperationStatus,
  [in] PCUNICODE_STRING      FailureReason
);

Parâmetros

[in] CallbackData

Ponteiro para o FLT_CALLBACK_DATA para FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Ponteiro para a estrutura de FLT_RELATED_OBJECTS para a operação BypassIO.

[in] OperationStatus

O código de erro NTSTATUS fornecido pelo filtro para o veto.

[in] FailureReason

Uma cadeia de caracteres exclusiva e descritiva que fornece detalhes sobre por que o filtro está vetando a solicitação de habilitação bypassIO.

Retornar valor

FltVetoBypassIo retorna STATUS_SUCCESS após a conclusão bem-sucedida; caso contrário, ele retorna um valor NTSTATUS, como um dos seguintes.

Valor	Significado
STATUS_BUFFER_TOO_SMALL	O buffer de saída do FSCTL é muito pequeno.
STATUS_INVALID_BUFFER_SIZE	O buffer de entrada do FSCTL é muito pequeno.
STATUS_INVALID_PARAMETER_3	Um código de erro apropriado não foi fornecido.
STATUS_INVALID_PARAMETER_4	Um motivo de falha apropriado não foi fornecido.
STATUS_NOT_SUPPORTED	A operação solicitada não tem suporte ou não foi solicitada de um retorno de chamada pré-operatório.

Comentários

Um minifiltro chama FltVetoBypassIo quando pretende vetar uma solicitação de FS_BPIO_OP_ENABLE ou FS_BPIO_OP_QUERY em um arquivo. Um minifiltro só deve chamar essa rotina de seu retorno de chamada pré-operação.

FltVetoBypassIo preenche a estrutura de FS_BPIO_OUTPUT alocada pelo chamador associada a CallbackData com as informações necessárias para vetar a solicitação BypassIO. O chamador deve fornecer um buffer grande o suficiente para manter a estrutura.

FltVetoBypassIo registra um evento ETW com o status, o motivo fornecido pelo filtro e o nome do filtro.

Consulte BypassIO para obter drivers de filtro e Suporte a operações bypassIO para obter mais informações.