FltGetStreamHandleContext, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetStreamHandleContext récupère un contexte défini pour un handle de flux par une instance de pilote minifilter donnée.

Syntaxe

NTSTATUS FLTAPI FltGetStreamHandleContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’instance de pilote minifilter dont le contexte doit être récupéré.

[in] FileObject

Pointeur vers un objet de fichier pour le handle de flux.

[out] Context

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse du contexte. Ce paramètre ne peut pas être défini sur NULL.

Valeur de retour

FltGetStreamHandleContext retourne STATUS_SUCCESS lorsqu’elle retourne correctement le contexte demandé. Sinon, elle retourne une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Retourner le code	Description
STATUS_NOT_FOUND	Aucun contexte correspondant n’a été trouvé sur ce fichier pour l’instant. Par conséquent, FltMgr définir contexte sur NULL_CONTEXT. Il s’agit d’un code d’erreur.
STATUS_NOT_SUPPORTED	Le système de fichiers ne prend pas en charge les contextes par flux pour ce flux de fichiers. Il s’agit d’un code d’erreur.

Remarques

Pour plus d’informations sur les contextes, consultez À propos des contextes minifilter.

FltGetStreamHandleContext récupère un contexte défini pour un handle de flux par un pilote minifilter donné.

FltGetStreamHandleContext incrémente le nombre de références sur le contexte vers lequel pointe le paramètre Context. Lorsque ce pointeur de contexte n’est plus nécessaire, l’appelant doit décrémenter son nombre de références en appelant FltReleaseContext. Ainsi, chaque appel réussi à FltGetStreamHandleContext doit être mis en correspondance par un appel ultérieur à FltReleaseContext.

Pour définir un contexte pour un handle de flux, appelez FltSetStreamHandleContext

Pour allouer un nouveau contexte, appelez FltAllocateContext.

Pour supprimer un contexte de handle de flux, appelez FltDeleteStreamHandleContext ou FltDeleteContext.