Funzione FsRtlInsertPerFileObjectContext (ntifs.h)

Articolo
12/22/2024

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 di FSRTL_PER_FILEOBJECT_CONTEXT allocata e inizializzata del chiamante da associare a FileObject. La struttura può essere utilizzata as-is o incorporata in una struttura di informazioni sul contesto definita dal driver per oggetto file. 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.

Osservazioni

Un driver di filtro del file system chiama FsRtlInsertPerFileObjectContext per associare la propria struttura di contesto per oggetto per 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 di contesto ptr nell'elenco di contesto per FileObject.

Tutte le strutture di informazioni di contesto per 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 di FSRTL_PER_FILEOBJECT_CONTEXT o una struttura di contesto definito per oggetto per file (contenente una struttura di FSRTL_PER_FILEOBJECT_CONTEXT inizializzata), è possibile recuperarla chiamando FsRtlLookupPerFileObjectContext o rimossa chiamando FsRtlRemovePerFileObjectContext.

Nota 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.

Fabbisogno

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

Vedere anche

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlLookupPerFileObjectContext

FsRtlRemovePerFileObjectContext

Condividi tramite