Fungsi FltGetStreamHandleContext (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltGetStreamHandleContext mengambil konteks yang diatur untuk handel aliran oleh instans driver minifilter tertentu.

Sintaks

NTSTATUS FLTAPI FltGetStreamHandleContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Penunjuk instans buram untuk instans driver minifilter yang konteksnya akan diambil.

[in] FileObject

Penunjuk ke objek file untuk handel aliran.

[out] Context

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima alamat konteks. Parameter ini tidak dapat diatur ke NULL.

Nilai kembali

FltGetStreamHandleContext mengembalikan STATUS_SUCCESS ketika berhasil mengembalikan konteks yang diminta. Jika tidak, ia mengembalikan nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_NOT_FOUND	Tidak ada konteks yang cocok yang ditemukan pada file ini saat ini, jadi FltMgr mengatur Konteks ke NULL_CONTEXT. Ini adalah kode kesalahan.
STATUS_NOT_SUPPORTED	Sistem file tidak mendukung konteks per aliran untuk aliran file ini. Ini adalah kode kesalahan.

Keterangan

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

FltGetStreamHandleContext mengambil konteks yang diatur untuk handel streaming oleh driver minifilter tertentu.

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

Untuk mengatur konteks untuk handel aliran, panggil FltSetStreamHandleContext

Untuk mengalokasikan konteks baru, panggil FltAllocateContext.

Untuk menghapus konteks handel aliran, panggil FltDeleteStreamHandleContext atau FltDeleteContext.