Funzione FsRtlInsertPerFileContext (ntifs.h)

  • Articolo

La routine FsRtlInsertPerFileContext associa un oggetto FSRTL_PER_FILE_CONTEXT a un oggetto contesto specificato dal driver per un file.

Sintassi

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

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] Ptr

Puntatore alla struttura di contesto specifica del driver.

Valore restituito

La routine FsRtlInsertPerFileContext restituisce STATUS_SUCCESS o un codice di errore appropriato, ad esempio:

Codice restituito Descrizione
STATUS_INVALID_DEVICE_REQUEST
 Il file system sottostante non supporta i contesti di file di filtro. È possibile utilizzare la macro FsRtlSupportsPerFileContexts per verificare se un file system supporta per ogni oggetto contesto di file.
STATUS_INSUFFICIENT_RESOURCES
 Il sistema non è riuscito ad allocare risorse (in genere memoria).

Commenti

La macro FsRtlGetPerFileContextPointer restituisce un Oggetto FileContextSupportPointer per un file aperto.

Parametri

FileObject

FILE_OBJECT

Puntatore a un oggetto file.

Valore restituito

PVOID

La macro FsRtlGetPerFileContextPointer restituisce un puntatore opaco utilizzato dal pacchetto FSRTL (File System Runtime Library) per tenere traccia dei contesti di file. La macro restituisce NULL se il file system non supporta l'uso di oggetti contesto per file con file.

La macro FsRtlGetPerFileContextPointer restituisce il puntatore da passare alle routine, ad esempio FsRtlInsertPerFileContext, FsRtlLookupPerFileContext e FsRtlRemovePerFileContext.

Per altre informazioni sull'uso e la creazione di oggetti di contesto, vedere Tracking Per-File Context in a Legacy File System Filter Driver.For more information about how to use and create context objects, see Tracking Per-File Context in a Legacy File System Filter Driver.

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

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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