Fungsi FltIsIoRedirectionAllowed (fltkernel.h)

  • Artikel

Rutinitas FltIsIoRedirectionAllowed menentukan apakah I/O dapat dialihkan dari instans filter sumber yang ditentukan ke instans filter lain yang ditentukan.

Sintaks

NTSTATUS FLTAPI FltIsIoRedirectionAllowed(
  [in]  PFLT_INSTANCE SourceInstance,
  [in]  PFLT_INSTANCE TargetInstance,
  [out] PBOOLEAN      RedirectionAllowed
);

Parameter

[in] SourceInstance

Instans filter pada tumpukan perangkat sumber.

[in] TargetInstance

Instans filter pada tumpukan perangkat target.

[out] RedirectionAllowed

Nilai TRUE jika semua I/O ke tumpukan perangkat sumber dapat dialihkan ke tumpukan 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

FltIsIoRedirectionAllowedForOperation