Funzione FsRtlLookupPerFileContext (ntifs.h)

  • Articolo

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

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

Rilevamento Per-File contesto in un driver di filtro del file system legacy