struktur FLT_RELATED_OBJECTS (fltkernel.h)

Artikel
02/26/2024

Struktur FLT_RELATED_OBJECTS berisi pointer buram untuk objek yang terkait dengan operasi.

Sintaks

typedef struct _FLT_RELATED_OBJECTS {
  USHORT        Size;
  USHORT        TransactionContext;
  PFLT_FILTER   Filter;
  PFLT_VOLUME   Volume;
  PFLT_INSTANCE Instance;
  PFILE_OBJECT  FileObject;
  PKTRANSACTION Transaction;
} FLT_RELATED_OBJECTS, *PFLT_RELATED_OBJECTS;

Anggota

Size

Ukuran, dalam byte, dari struktur FLT_RELATED_OBJECTS.

TransactionContext

Anggota buram yang berisi nilai ID miniversi transaksi jika anggota Transaksi bukan NULL. Jika TransaksiNULL, nilai TransactionContext tidak ditentukan.

Filter

Penunjuk filter buram untuk driver minifilter yang rutinitas panggilan baliknya dipanggil untuk operasi. Pointer ini secara unik mengidentifikasi driver minifilter dan tetap konstan selama driver minifilter dimuat.

Volume

Penunjuk volume buram untuk volume yang terkait dengan operasi. Pointer ini secara unik mengidentifikasi volume dan tetap konstan selama masa pakai tumpukan perangkat volume.

Instance

Penunjuk instans buram untuk instans driver minifilter yang terkait dengan operasi. Pointer ini secara unik mengidentifikasi instans dan tetap konstan selama instans dilampirkan ke volume.

FileObject

Arahkan ke objek file, jika ada, untuk operasi.

Transaction

Pada Windows Vista dan yang lebih baru, anggota ini adalah penunjuk transaksi buram ke transaksi yang terkait dengan operasi. Operasi akan menjadi bagian dari transaksi jika nilai anggota ini bukan NULL. Jika nilai anggota ini adalah NULL, operasi tidak akan menjadi bagian dari transaksi. Pada sistem operasi Windows sebelum Windows Vista, nilai anggota ini akan selalu NULL.

Keterangan

Struktur FLT_RELATED_OBJECTS dialokasikan oleh manajer filter dan berisi pointer buram untuk objek yang terkait dengan operasi I/O atau pengaturan instans atau operasi teardown.

Konten struktur FLT_RELATED_OBJECTS diatur oleh manajer filter. Driver minifilter tidak dapat langsung mengubah isi struktur ini. Namun, jika driver minifilter memodifikasi instans target atau objek file target untuk operasi I/O dalam struktur FLT_IO_PARAMETER_BLOCK untuk operasi, manajer filter memodifikasi nilai Instans yang sesuai atau anggota FileObject dari struktur FLT_RELATED_OBJECTS yang diteruskan ke driver minifilter yang lebih rendah. Untuk informasi selengkapnya, lihat Memodifikasi Parameter untuk Operasi I/O.

Driver minifilter menerima pointer ke struktur FLT_RELATED_OBJECTS sebagai parameter input FltObjects ke jenis rutinitas panggilan balik berikut:

PFLT_POST_OPERATION_CALLBACK

PFLT_PRE_OPERATION_CALLBACK

PFLT_INSTANCE_SETUP_CALLBACK

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK

PFLT_INSTANCE_TEARDOWN_CALLBACK

Untuk mengambil pointer ke konteks driver minifilter untuk objek dalam struktur FLT_RELATED_OBJECTS, panggil FltGetContexts.

Catatantypedef CONST struct _FLT_RELATED_OBJECTS *PCFLT_RELATED_OBJECTS;