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
| 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per