Funzione FsRtlInsertPerFileObjectContext (ntifs.h)

Articolo
03/08/2023

Per un driver di filtro del file system "legacy", la funzione FsRtlInsertPerFileObjectContext associa le informazioni di contesto a un oggetto file.

Sintassi

NTSTATUS FsRtlInsertPerFileObjectContext(
  [in] PFILE_OBJECT                  FileObject,
  [in] PFSRTL_PER_FILEOBJECT_CONTEXT Ptr
);

Parametri

[in] FileObject

Puntatore all'oggetto file per il quale associare le informazioni di contesto (date dal parametro Ptr ).

[in] Ptr

Puntatore a una struttura FSRTL_PER_FILEOBJECT_CONTEXT allocata al chiamante e inizializzata da associare a FileObject. La struttura può essere usata così come è o incorporata in una struttura di informazioni sul contesto per oggetto file definita dal driver. Per inizializzare la struttura, utilizzare la macro FsRtlInitPerFileObjectContext .

Valore restituito

FsRtlInsertPerFileObjectContext restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura delle informazioni di contesto è stata associata correttamente all'oggetto file.
STATUS_INVALID_PARAMETER	Il parametro FileObject è NULL.
STATUS_INSUFFICIENT_RESOURCES	Il sistema non dispone di risorse sufficienti per completare l'operazione. Ad esempio, non è stato possibile allocare un'estensione dell'oggetto file per FileObject.

Commenti

Un driver di filtro del file system chiama FsRtlInsertPerFileObjectContext per associare la propria struttura di contesto per oggetto file a un oggetto file. La struttura di contesto contiene informazioni di contesto che il driver di filtro gestisce per l'oggetto file. La funzione FsRtlInsertPerStreamContext inserisce la struttura del contesto Ptr nell'elenco di contesto per FileObject.

Tutte le strutture di informazioni sul contesto per ogni oggetto file devono essere o contenere una struttura di FSRTL_PER_FILEOBJECT_CONTEXT inizializzata. Utilizzare la macro FsRtlInitPerFileObjectContext per inizializzare una struttura FSRTL_PER_FILEOBJECT_CONTEXT.

Dopo aver associato una struttura FSRTL_PER_FILEOBJECT_CONTEXT o una struttura di contesto per oggetto file definita dal filtro (contenente una struttura di FSRTL_PER_FILEOBJECT_CONTEXT inizializzata), è possibile recuperarla chiamando FsRtlLookupPerFileObjectContext o rimossa chiamando FsRtlRemovePerFileObjectContext.

Nota I driver minifilter del file system non devono usare le funzioni FsRtlXxxPerFileObjectContext . I minifiltri possono invece usare le funzioni FltXxxContext per associare le informazioni di contesto a un oggetto file. Per un elenco completo, vedere l'argomento FSRTL_PER_FILEOBJECT_CONTEXT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Fltkernel.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedi anche

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlLookupPerFileObjectContext

FsRtlRemovePerFileObjectContext