Funzione FsRtlLookupPerFileObjectContext (ntifs.h)

Per un driver di filtro del file system "legacy", la funzione FsRtlLookupPerFileObjectContext recupera le informazioni di contesto precedentemente associate a un oggetto file.

Sintassi

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Parametri

[in] FileObject

Puntatore a un oggetto file per il quale eseguire query sulle informazioni sul contesto.

[in, optional] OwnerId

Puntatore a una variabile allocata dal chiamante che identifica in modo univoco il filtro proprietario della struttura del contesto per ogni oggetto file. Il formato di questa variabile è specifico del driver di filtro.

[in, optional] InstanceId

Puntatore a una variabile allocata dal chiamante che può essere usata per distinguere tra le strutture di contesto per oggetto file create dallo stesso driver di filtro. Il formato di questa variabile è specifico del driver di filtro. Questo parametro è facoltativo e può essere NULL.

Valore restituito

FsRtlLookupPerFileObjectContext restituisce un puntatore al primo contesto corrispondente per ogni oggetto file trovato. Se non viene trovata alcuna corrispondenza, FsRtlLookupPerFileObjectContext restituisce NULL.

Commenti

Un driver di filtro del file system "legacy" chiama FsRtlLookupPerFileObjectContext per recuperare la struttura del contesto per oggetto file per un oggetto file. La struttura di contesto contiene informazioni di contesto che il driver di filtro gestisce per l'oggetto file. Questa struttura di contesto deve essere stata precedentemente associata all'oggetto file chiamando la funzione FsRtlInsertPerFileObjectContext .

Se la struttura FSRTL_PER_FILEOBJECT_CONTEXT è incorporata in una struttura di contesto definita per ogni oggetto file, è possibile utilizzare la macro CONTAINING_RECORD per ottenere un puntatore all'intestazione della struttura definita dal filtro.

Per inizializzare una struttura di contesto per oggetto file, utilizzare la macro FsRtlInitPerFileObjectContext .

Per associare una struttura di contesto inizializzata per oggetto file a un oggetto file, utilizzare la funzione FsRtlInsertPerFileObjectContext .

Per rimuovere una struttura di contesto per oggetto file associata a un oggetto file, utilizzare la funzione FsRtlRemovePerFileObjectContext .

Requisiti

Vedi anche

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext