Fungsi FltVetoBypassIo (fltkernel.h)

Artikel
02/29/2024

FltVetoBypassIo mengambil informasi yang diperlukan untuk memveto permintaan BypassIO.

Sintaks

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

Parameter

[in] CallbackData

Arahkan ke FLT_CALLBACK_DATA untuk FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Arahkan ke struktur FLT_RELATED_OBJECTS untuk operasi BypassIO.

[in] OperationStatus

Kode kesalahan NTSTATUS yang disediakan oleh filter untuk veto.

[in] FailureReason

String deskriptif unik yang menyediakan detail tentang mengapa filter mem-veto permintaan pengaktifan BypassIO.

Nilai kembali

FltVetoBypassIo mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan; jika tidak, ia mengembalikan nilai NTSTATUS seperti salah satu dari berikut ini.

Nilai	Makna
STATUS_BUFFER_TOO_SMALL	Buffer output FSCTL terlalu kecil.
STATUS_INVALID_BUFFER_SIZE	Buffer input FSCTL terlalu kecil.
STATUS_INVALID_PARAMETER_3	Kode galat yang sesuai tidak disediakan.
STATUS_INVALID_PARAMETER_4	Alasan kegagalan yang sesuai tidak disediakan.
STATUS_NOT_SUPPORTED	Operasi yang diminta tidak didukung atau tidak diminta dari panggilan balik pra-operasi.

Keterangan

Minifilter memanggil FltVetoBypassIo ketika ingin memveto permintaan FS_BPIO_OP_ENABLE atau FS_BPIO_OP_QUERY pada file. Minifilter hanya boleh memanggil rutinitas ini dari panggilan balik pra-operasinya.

FltVetoBypassIo mengisi struktur FS_BPIO_OUTPUT yang dialokasikan pemanggil yang terkait dengan CallbackData dengan informasi yang diperlukan untuk memveto permintaan BypassIO. Pemanggil harus menyediakan buffer yang cukup besar untuk menahan struktur.

FltVetoBypassIo mencatat peristiwa ETW dengan status, alasan yang disediakan filter, dan nama filter.

Lihat BypassIO untuk driver filter dan operasi Supporting BypassIO untuk informasi selengkapnya.