Funzione FsRtlLookupPerFileContext (ntifs.h)
La routine FsRtlLookupPerFileContext restituisce un puntatore a un oggetto FSRTL_PER_FILE_CONTEXT associato a un file specificato.
Sintassi
PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
[in] PVOID *PerFileContextPointer,
[in, optional] PVOID OwnerId,
[in, optional] PVOID InstanceId
);
Parametri
[in] PerFileContextPointer
Puntatore a un puntatore opaco usato dal pacchetto FSRTL (File System Runtime Library) per tenere traccia dei contesti di file. Per recuperare questo puntatore da un oggetto file, utilizzare la macro FsRtlGetPerFileContextPointer .
[in, optional] OwnerId
Puntatore a una variabile allocata dal driver di filtro che identifica in modo univoco il proprietario della struttura del contesto per file. Il formato di questa variabile è specifico del driver di filtro. Questo parametro è facoltativo, ma deve essere diverso da NULL se InstanceId è diverso da NULL.
[in, optional] InstanceId
Puntatore a una variabile allocata dal driver di filtro che può essere usata per distinguere tra le strutture di contesto per file create dallo stesso driver di filtro. Il formato di questa variabile è specifico del driver di filtro. Questo parametro è facoltativo e,
Valore restituito
Puntatore alla prima struttura FSRTL_PER_FILE_CONTEXT che corrisponde a OwnerId e InstanceId, se specificato o NULL se non viene trovata alcuna corrispondenza o il file system non supporta contesti per file.
Commenti
Non specificando OwnerID e InstanceId, un driver di filtro può cercare il primo contesto associato a un file.
Se il file system non supporta gli oggetti contesto per file, viene restituito NULL . Utilizzare la macro FsRtlSupportsPerFileContexts per determinare se un file system supporta oggetti contesto per file.
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
Rilevamento Per-File contesto in un driver di filtro del file system legacy