Fungsi FltGetTransactionContext (fltkernel.h)
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | fltkernel.h (termasuk Fltkernel.h) |
Pustaka | FltMgr.lib |
DLL | FltMgr.sys |
IRQL | <= APC_LEVEL |