Fungsi FltGetTransactionContext (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltGetTransactionContext mengambil konteks yang ditetapkan untuk transaksi oleh driver minifilter tertentu.

Sintaks

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil.

[in] Transaction

Pointer transaksi buram untuk transaksi yang konteksnya sedang diambil.

[out] Context

Penunjuk ke variabel yang dialokasikan penelepon yang menerima alamat konteks transaksi.

Nilai kembali

FltGetTransactionContext mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti berikut ini:

Menampilkan kode	Deskripsi
STATUS_NOT_FOUND	Tidak ditemukan konteks yang cocok. Ini adalah kode kesalahan.

Keterangan

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

FltGetTransactionContext menaikkan jumlah referensi pada konteks yang ditunjuk parameter Konteks . Ketika penunjuk konteks ini tidak lagi diperlukan, pemanggil harus mengurangi jumlah referensinya dengan memanggil FltReleaseContext. Dengan demikian setiap panggilan yang berhasil ke FltGetTransactionContext harus dicocokkan dengan panggilan berikutnya ke FltReleaseContext.

Untuk mengatur konteks transaksi, panggil FltSetTransactionContext.

Untuk mengalokasikan konteks transaksi baru, panggil FltAllocateContext.

Untuk menghapus konteks transaksi, panggil FltDeleteTransactionContext atau FltDeleteContext.