Función FsRtlInsertPerFileObjectContext (ntifs.h)

  • Artículo

Para un controlador de filtro del sistema de archivos "heredado", la función FsRtlInsertPerFileObjectContext asocia información de contexto a un objeto de archivo.

Sintaxis

NTSTATUS FsRtlInsertPerFileObjectContext(
  [in] PFILE_OBJECT                  FileObject,
  [in] PFSRTL_PER_FILEOBJECT_CONTEXT Ptr
);

Parámetros

[in] FileObject

Puntero al objeto de archivo para el que se va a asociar información de contexto (dada por el parámetro Ptr ).

[in] Ptr

Puntero a una estructura de FSRTL_PER_FILEOBJECT_CONTEXT asignada por el autor de la llamada e inicializada que se va a asociar con FileObject. La estructura se puede usar tal como está o incrustada en una estructura de información de contexto definida por el controlador por objeto. Para inicializar la estructura, use la macro FsRtlInitPerFileObjectContext .

Valor devuelto

FsRtlInsertPerFileObjectContext devuelve un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto Descripción
STATUS_SUCCESS
 La estructura de información de contexto se asoció correctamente con el objeto de archivo.
STATUS_INVALID_PARAMETER
 El parámetro FileObject es NULL.
STATUS_INSUFFICIENT_RESOURCES
 El sistema carece de recursos suficientes para completar la operación. Por ejemplo, no se pudo asignar una extensión de objeto de archivo para FileObject.

Comentarios

Un controlador de filtro del sistema de archivos llama a FsRtlInsertPerFileObjectContext para asociar su propia estructura de contexto por objeto de archivo con un objeto de archivo. La estructura de contexto contiene información de contexto que mantiene el controlador de filtro para el objeto de archivo. La función FsRtlInsertPerStreamContext inserta la estructura de contexto Ptr en la lista de contextos de FileObject.

Todas las estructuras de información de contexto por objeto de archivo deben ser o contener una estructura de FSRTL_PER_FILEOBJECT_CONTEXT inicializada. Use la macro FsRtlInitPerFileObjectContext para inicializar una estructura de FSRTL_PER_FILEOBJECT_CONTEXT.

Después de asociar una estructura de FSRTL_PER_FILEOBJECT_CONTEXT o estructura de contexto definida por cada objeto por archivo (que contiene una estructura de FSRTL_PER_FILEOBJECT_CONTEXT inicializada) a un objeto de archivo, se puede recuperar llamando a FsRtlLookupPerFileObjectContext o quitando mediante una llamada a FsRtlRemovePerFileObjectContext.

Nota Los controladores de minifiltro del sistema de archivos no deben usar las funciones FsRtlXxxPerFileObjectContext . En su lugar, los minifiltros pueden usar las funciones de contextoFltXxx para asociar información de contexto a un objeto de archivo. Para obtener una lista completa, consulte el tema FSRTL_PER_FILEOBJECT_CONTEXT .
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Universal
Encabezado ntifs.h (incluya Fltkernel.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlLookupPerFileObjectContext

FsRtlRemovePerFileObjectContext