Export (0) Print
Expand All
Expand Minimize

FsRtlRemovePerFileContext routine

The FsRtlRemovePerFileContext routine returns a pointer to a FSRTL_PER_FILE_CONTEXT object that is associated with a file. FsRtlRemovePerFileContext removes the FSRTL_PER_FILE_CONTEXT object from the list it occupies, along with the associated driver specific context information.

Syntax


PFSRTL_PER_FILE_CONTEXT FsRtlRemovePerFileContext(
  _In_      PVOID *PerFileContextPointer,
  _In_opt_  PVOID OwnerId,
  _In_opt_  PVOID InstanceId
);

Parameters

PerFileContextPointer [in]

A pointer to an opaque pointer that is used by the file system runtime library (FSRTL) package to track file contexts. To obtain this pointer from a file object, use the FsRtlGetPerFileContextPointer macro.

OwnerId [in, optional]

A pointer to a filter driver-allocated variable that uniquely identifies the owner of the per-file context structure. This parameter is optional, but must be non-NULL if InstanceId is non-NULL.

InstanceId [in, optional]

A pointer to a filter driver-allocated variable that can be used to distinguish among per-file context structures that are created by the same filter driver. This parameter is optional.

Return value

A pointer to the first FSRTL_PER_FILE_CONTEXT that matches the OwnerId and InstanceId, if specified. If no match is found or if the system does not support per file context information, this routine returns NULL.

Remarks

FsRtlRemovePerFileContext removes only the first matching per-file context structure that it finds. If there are additional matching per-file contexts, the filter driver must call FsRtlRemovePerFileContext as many times as required to remove them all.

The file system filter driver must free the memory that is used for this context information after the FSRTL_PER_FILE_CONTEXT has been removed.

Use this routine for your drivers to remove contexts only when the driver must discard per-file context information while the file is still open. Contexts are removed when a file is closed by using FsRtlTeardownPerFileContexts.

Note  

  • Do not use this routine inside your FreeCallback routine. The file system removes contexts from the list before that routine is called.

  • Do not use this routine inside your IRP_CLOSE handler. You will not be notified when the stream is torn down.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating system.

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<=APC_LEVEL

See also

FSRTL_PER_FILE_CONTEXT
FsRtlGetPerFileContextPointer
FsRtlInsertPerFileContext
FsRtlLookupPerFileContext
Tracking Per-File Context in a Legacy File System Filter Driver

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft