Función FltGetStreamHandleContext (fltkernel.h)

La rutina FltGetStreamHandleContext recupera un contexto que se estableció 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 flujo.

[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:

Observaciones

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, todas las llamadas correctas a fltGetStreamHandleContext deben 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 flujo, llame a FltDeleteStreamHandleContext o FltDeleteContext.

Requisitos

Consulte también

fltAllocateContext

fltDeleteContext

fltDeleteStreamHandleContext

fltReleaseContext

fltSetStreamHandleContext