Bagikan melalui

Fungsi FsRtlInsertPerFileContext (ntifs.h)

  • Artikel

Rutinitas FsRtlInsertPerFileContext mengaitkan objek FSRTL_PER_FILE_CONTEXT dengan objek konteks yang ditentukan driver untuk file.

Sintaks

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

Parameter

[in] PerFileContextPointer

Pointer ke pointer buram yang digunakan oleh paket pustaka runtime sistem file (FSRTL) untuk melacak konteks file. Untuk mengambil penunjuk ini dari objek file, gunakan makro FsRtlGetPerFileContextPointer .

[in] Ptr

Penunjuk ke struktur konteks khusus driver.

Nilai kembali

Rutinitas FsRtlInsertPerFileContext mengembalikan STATUS_SUCCESS, atau kode kesalahan yang sesuai, seperti:

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST
 Sistem file yang mendasar tidak mendukung konteks file filter. Anda dapat menggunakan makro FsRtlSupportsPerFileContexts untuk memeriksa apakah sistem file mendukung per objek konteks file.
STATUS_INSUFFICIENT_RESOURCES
 Sistem tidak dapat mengalokasikan sumber daya (biasanya memori).

Keterangan

Makro FsRtlGetPerFileContextPointer mengembalikan FileContextSupportPointer untuk file yang terbuka.

Parameter

FileObject

FILE_OBJECT

Penunjuk ke objek file.

Nilai kembali

PVOID

Makro FsRtlGetPerFileContextPointer mengembalikan penunjuk buram yang digunakan oleh paket pustaka runtime sistem file (FSRTL) untuk melacak konteks file. Makro mengembalikan NULL jika sistem file tidak mendukung penggunaan objek konteks per file dengan file.

Makro FsRtlGetPerFileContextPointer mengembalikan penunjuk untuk diteruskan ke rutinitas seperti FsRtlInsertPerFileContext, FsRtlLookupPerFileContext, dan FsRtlRemovePerFileContext.

Untuk informasi selengkapnya tentang cara menggunakan dan membuat objek konteks, lihat Melacak konteks Per-File dalam Driver Filter Sistem File Warisan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Target Platform Universal
Header ntifs.h (termasuk FltKernel.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

Lihat juga

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

Melacak Konteks Per-File dalam Driver Filter Sistem File Warisan