Fungsi FltDetachVolume (fltkernel.h)

  • Artikel

FltDetachVolume mencopot instans driver minifilter dari volume.

Sintaks

NTSTATUS FLTAPI FltDetachVolume(
  [in, out]      PFLT_FILTER      Filter,
  [in, out]      PFLT_VOLUME      Volume,
  [in, optional] PCUNICODE_STRING InstanceName
);

Parameter

[in, out] Filter

Penunjuk filter buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in, out] Volume

Penunjuk volume buram untuk volume tempat instans terpasang. Parameter ini diperlukan dan tidak boleh NULL.

[in, optional] InstanceName

Pointer ke struktur UNICODE_STRING yang berisi nama instans untuk instans yang akan dihapus. Parameter ini bersifat opsional dan dapat berupa NULL. Jika NULL, instans pencocokan tertinggi akan dihapus.

Nilai kembali

FltDetachVolume mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut:

Menampilkan kode Deskripsi
STATUS_FLT_DELETING_OBJECT
 FltDetachVolume menemukan instans yang cocok, tetapi instans sedang ditimpa. Ini adalah kode kesalahan.
STATUS_FLT_INSTANCE_NOT_FOUND
 Tidak ditemukan instans yang cocok. Ini adalah kode kesalahan.

Keterangan

FltDetachVolume melepaskan instans driver minifilter dari volume dan merobek instans.

Untuk melampirkan instans driver minifilter ke volume, panggil FltAttachVolume atau FltAttachVolumeAtAltitude.

Untuk membandingkan ketinggian dua instans driver minifilter yang melekat pada volume yang sama, panggil FltCompareInstanceAltitudes.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header fltkernel.h (termasuk Fltkernel.h)
Pustaka FltMgr.lib
IRQL <= APC_LEVEL

Lihat juga

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName