Partager via


FsRtlInsertPerFileContext, fonction (ntifs.h)

La routine FsRtlInsertPerFileContext associe un objet FSRTL_PER_FILE_CONTEXT à un objet de contexte spécifié par le pilote pour un fichier.

Syntaxe

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

Paramètres

[in] PerFileContextPointer

Pointeur vers un pointeur opaque utilisé par le package FSRTL (File System Runtime Library) pour suivre les contextes de fichier. Pour récupérer ce pointeur à partir d’un objet de fichier, utilisez la macro FsRtlGetPerFileContextPointer.

[in] Ptr

Pointeur vers la structure de contexte spécifique au pilote.

Valeur de retour

La routine FsRtlInsertPerFileContext retourne STATUS_SUCCESS, ou un code d’erreur approprié, tel que :

Retourner le code Description
STATUS_INVALID_DEVICE_REQUEST
Le système de fichiers sous-jacent ne prend pas en charge les contextes de fichier de filtre. Vous pouvez utiliser la macro FsRtlSupportsPerFileContexts pour vérifier si un système de fichiers prend en charge les objets de contexte de fichier.
STATUS_INSUFFICIENT_RESOURCES
Le système n’a pas pu allouer de ressources (généralement la mémoire).

Remarques

La macro FsRtlGetPerFileContextPointer retourne une FileContextSupportPointer pour un fichier ouvert.

Paramètres

FileObject

FILE_OBJECT

Pointeur vers un objet de fichier.

Valeur de retour

PVOID

La macro FsRtlGetPerFileContextPointer retourne un pointeur opaque utilisé par le package FSRTL (File System Runtime Library) pour suivre les contextes de fichier. La macro retourne NULL si le système de fichiers ne prend pas en charge l’utilisation d’objets de contexte par fichier avec des fichiers.

La macro FsRtlGetPerFileContextPointer retourne le pointeur à passer à des routines telles que FsRtlInsertPerFileContext, FsRtlLookupPerFileContextet FsRtlRemovePerFileContext.

Pour plus d’informations sur l’utilisation et la création d’objets de contexte, consultez Tracking Per-File Context in a Legacy File System Filter Driver.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista
plateforme cible Universel
d’en-tête ntifs.h (include FltKernel.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

Voir aussi

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

Per-File contexte de suivi dans un pilote de filtre de système de fichiers hérité