Función FsRtlLookupPerFileObjectContext (ntifs.h)

Para un controlador de filtro del sistema de archivos "heredado", la función FsRtlLookupPerFileObjectContext recupera información de contexto asociada previamente a un objeto de archivo.

Sintaxis

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Parámetros

[in] FileObject

Puntero a un objeto de archivo para el que se va a consultar información de contexto.

[in, optional] OwnerId

Puntero a una variable asignada por el autor de la llamada que identifica de forma única el filtro propietario de la estructura de contexto por archivo-objeto. El formato de esta variable es específico del controlador de filtro.

[in, optional] InstanceId

Puntero a una variable asignada por el autor de la llamada que se puede usar para distinguir entre las estructuras de contexto por objeto de archivo creadas por el mismo controlador de filtro. El formato de esta variable es específico del controlador de filtro. Este parámetro es opcional y se puede NULL.

Valor devuelto

FsRtlLookupPerFileObjectContext devuelve un puntero al primer contexto de objeto por archivo coincidente que se encuentra. Si no se encuentra ninguna coincidencia, FsRtlLookupPerFileObjectContext devuelve NULL.

Observaciones

Un controlador de filtro del sistema de archivos "heredado" llama a FsRtlLookupPerFileObjectContext para recuperar su estructura de contexto por objeto de archivo para un objeto de archivo. La estructura de contexto contiene información de contexto que mantiene el controlador de filtro para el objeto de archivo. Esta estructura de contexto debe haberse asociado previamente al objeto de archivo llamando a la función FsRtlInsertPerFileObjectContext.

Si la estructura FSRTL_PER_FILEOBJECT_CONTEXT está incrustada en una estructura de contexto definida por cada archivo-objeto, la macro CONTAINING_RECORD se puede usar para obtener un puntero al encabezado de la estructura definida por filtro.

Para inicializar una estructura de contexto por objeto de archivo, use la macro de FsRtlInitPerFileObjectContext .

Para asociar una estructura de contexto por objeto por archivo inicializada con un objeto de archivo, use la función FsRtlInsertPerFileObjectContext.

Para quitar una estructura de contexto por objeto de archivo asociada a un objeto de archivo, use la función FsRtlRemovePerFileObjectContext.

Nota Los controladores de minifiltro del sistema de archivos no deben usar las funciones deXxx FsRtlPerFileObjectContext. En su lugar, los minifiltros pueden usar las funciones FltXxxContext 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	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Universal
encabezado de	ntifs.h (include Fltkernel.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL

Consulte también

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext