Función FltGetStreamHandleContext (fltkernel.h)

Artículo
04/27/2023

La rutina FltGetStreamHandleContext recupera un contexto establecido para un controlador de flujo mediante una instancia de controlador de minifiltro determinada.

Sintaxis

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

Parámetros

[in] Instance

Puntero de instancia opaco para la instancia del controlador de minifiltro cuyo contexto se va a recuperar.

[in] FileObject

Puntero a un objeto de archivo para el identificador de secuencia.

[out] Context

Puntero a una variable asignada por el autor de la llamada que recibe la dirección del contexto. Este parámetro no se puede establecer en NULL.

Valor devuelto

FltGetStreamHandleContext devuelve STATUS_SUCCESS cuando devuelve correctamente el contexto solicitado. De lo contrario, devuelve un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_NOT_FOUND	No se encontró ningún contexto coincidente en este archivo en este momento, por lo que FltMgr estableció Context en NULL_CONTEXT. Se trata de un código de error.
STATUS_NOT_SUPPORTED	El sistema de archivos no admite contextos por secuencia para esta secuencia de archivos. Se trata de un código de error.

Comentarios

Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.

FltGetStreamHandleContext recupera un contexto establecido para un controlador de minifiltro determinado para un controlador de flujo.

FltGetStreamHandleContext incrementa el recuento de referencias en el contexto al que apunta el parámetro Context . Cuando este puntero de contexto ya no es necesario, el autor de la llamada debe disminuir su recuento de referencias llamando a FltReleaseContext. Por lo tanto, cada llamada correcta a FltGetStreamHandleContext debe coincidir con una llamada posterior a FltReleaseContext.

Para establecer un contexto para un identificador de secuencia, llame a FltSetStreamHandleContext.

Para asignar un nuevo contexto, llame a FltAllocateContext.

Para eliminar un contexto de identificador de secuencia, llame a FltDeleteStreamHandleContext o FltDeleteContext.