Partager via

Fonction FsRtlInsertPerFileContext (ntifs.h)

  • Article

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 fichier, utilisez la macro FsRtlGetPerFileContextPointer .

[in] Ptr

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

Valeur retournée

La routine FsRtlInsertPerFileContext retourne STATUS_SUCCESS, ou un code d’erreur approprié, par exemple :

Code de retour 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 case activée 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 de la mémoire).

Remarques

La macro FsRtlGetPerFileContextPointer retourne un FichierContextSupportPointer pour un fichier ouvert.

Paramètres

FileObject

FILE_OBJECT

Pointeur vers un objet file.

Valeur retournée

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, FsRtlLookupPerFileContext et FsRtlRemovePerFileContext.

Pour plus d’informations sur l’utilisation et la création d’objets de contexte, consultez Suivi Per-File contexte dans un pilote de filtre de système de fichiers hérité.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Universal
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

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