Función FltVetoBypassIo (fltkernel.h)

Artículo
02/26/2024

FltVetoBypassIo recupera información necesaria para vetar una solicitud bypassIO.

Sintaxis

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

Parámetros

[in] CallbackData

Puntero al FLT_CALLBACK_DATA para FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Puntero a la estructura de FLT_RELATED_OBJECTS para la operación BypassIO.

[in] OperationStatus

El código de error NTSTATUS proporcionado por el filtro para el vetado.

[in] FailureReason

Cadena única y descriptiva que proporciona detalles sobre por qué el filtro está vetando la solicitud de habilitación bypassIO.

Valor devuelto

FltVetoBypassIo devuelve STATUS_SUCCESS tras completarse correctamente; de lo contrario, devuelve un valor NTSTATUS como uno de los siguientes.

Valor	Significado
STATUS_BUFFER_TOO_SMALL	El búfer de salida del FSCTL es demasiado pequeño.
STATUS_INVALID_BUFFER_SIZE	El búfer de entrada del FSCTL es demasiado pequeño.
STATUS_INVALID_PARAMETER_3	No se proporcionó un código de error adecuado.
STATUS_INVALID_PARAMETER_4	No se proporcionó un motivo de error adecuado.
STATUS_NOT_SUPPORTED	No se admite la operación solicitada o no se solicitó desde una devolución de llamada previa.

Comentarios

Un minifiltro llama a FltVetoBypassIo cuando pretende vetar una solicitud de FS_BPIO_OP_ENABLE o FS_BPIO_OP_QUERY en un archivo. Un minifiltro solo debe llamar a esta rutina desde su devolución de llamada previa a la operación.

FltVetoBypassIo rellena la estructura de FS_BPIO_OUTPUT asignada por el autor de la llamada asociada a CallbackData con la información necesaria para vetar la solicitud BypassIO. El autor de la llamada debe proporcionar un búfer lo suficientemente grande como para contener la estructura.

FltVetoBypassIo registra un evento ETW con el estado, el motivo proporcionado por el filtro y el nombre del filtro.

Consulte BypassIO para los controladores de filtro y las operaciones de BypassIO auxiliares para obtener más información.