Fungsi FltIsIoRedirectionAllowedForOperation (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltIsIoRedirectionAllowedForOperation menentukan apakah I/O dapat dialihkan dari instans filter yang terkait dengan struktur FLT_CALLBACK_DATA yang ditentukan ke instans filter yang ditentukan.

Sintaks

NTSTATUS FLTAPI FltIsIoRedirectionAllowedForOperation(
  [in]            PFLT_CALLBACK_DATA Data,
  [in]            PFLT_INSTANCE      TargetInstance,
  [out]           PBOOLEAN           RedirectionAllowedThisIo,
  [out, optional] PBOOLEAN           RedirectionAllowedAllIo
);

Parameter

[in] Data

Struktur FLT_CALLBACK_DATA yang mewakili operasi I/O.

[in] TargetInstance

Instans filter pada tumpukan perangkat target.

[out] RedirectionAllowedThisIo

Nilai TRUE jika I/O ini dapat dialihkan ke tumpukan perangkat target dengan mengubah instans filter yang direferensikan.

[out, optional] RedirectionAllowedAllIo

Parameter opsional ini memiliki nilai TRUE jika semua I/O ke tumpukan perangkat tempat operasi I/O dikeluarkan dapat dialihkan ke perangkat target dengan mengubah instans filter yang direferensikan, jika tidak FALSE.

Nilai kembali

Nilai NTSTATUS STATUS_SUCCESS untuk keberhasilan atau STATUS_NOT_SUPPORTED jika pengalihan tidak didukung.

Keterangan

Operasi I/O dikaitkan dengan struktur FLT_CALLBACK_DATA . Struktur tersebut berisi referensi ke objek PFLT_IO_PARAMETER_BLOCK , yang berisi referensi ke FLT_INSTANCE minifilter yang terkait dengan operasi I/O.

Jika RedirectionAllowedTRUE, minifilter dapat mengalihkan I/O dengan mengubah instans tersebut ke instans target baru.

Jika RedirectionAllowedfalse, minifilter perlu mengalokasikan objek data panggilan balik baru untuk mengeluarkan I/O pada tumpukan target atau memanggil FltAdjustDeviceStackSizeForIoRedirection untuk meningkatkan ukuran tumpukan perangkat sumber.

Catatan Minifilter tidak boleh memodifikasi referensi ke FLT_INSTANCE sebelum memverifikasi bahwa pengalihan dapat dilakukan dengan cara ini. Gunakan FltIsIoRedirectionAllowedForOperation atau FltIsIoRedirectionAllowed.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	fltkernel.h (termasuk FltKernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<=DISPATCH_LEVEL

Lihat juga

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowed

Bagikan melalui