Compartir a través de


Función FltGetInstanceContext (fltkernel.h)

La rutina FltGetInstanceContext recupera un contexto establecido para una instancia por un controlador de minifiltro determinado.

Sintaxis

NTSTATUS FLTAPI FltGetInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *Context
);

Parámetros

[in] Instance

Puntero de instancia opaco para la instancia.

[out] Context

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

Valor devuelto

FltGetInstanceContext devuelve STATUS_SUCCESS cuando devuelve correctamente el contexto de instancia solicitado. De lo contrario, devuelve un valor NTSTATUS adecuado, como el siguiente:

Código devuelto Descripción
STATUS_NOT_FOUND No se encontró ningún contexto coincidente en esta instancia en este momento. FltMgr establece Context en NULL_CONTEXT. 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.

FltGetInstanceContext recupera un contexto establecido para una instancia por un controlador de minifiltro determinado.

FltGetInstanceContext 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 FltGetInstanceContext debe coincidir con una llamada posterior a FltReleaseContext.

Para establecer un contexto para una instancia, llame a FltSetInstanceContext.

Para asignar un nuevo contexto, llame a FltAllocateContext.

Para eliminar un contexto de archivo, llame a FltDeleteInstanceContext o FltDeleteContext.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado fltkernel.h (incluya Fltkernel.h)
Library FltMgr.lib
Archivo DLL Fltmgr.sys
IRQL <= APC_LEVEL

Consulte también

FltAllocateContext

FltDeleteContext

FltDeleteInstanceContext

FltReleaseContext

FltSetInstanceContext