Fungsi FltVetoBypassIo (fltkernel.h)
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 11 |
Header | fltkernel.h |
IRQL | <= APC_LEVEL |