Función FltGetSectionContext (fltkernel.h)
La rutina FltGetSectionContext recupera un contexto de sección que se creó para una secuencia de archivos mediante una instancia de controlador de minifiltro especificada.
Sintaxis
NTSTATUS FLTAPI FltGetSectionContext(
[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 la secuencia.
[out] Context
Puntero a una variable asignada por el autor de la llamada que recibe la dirección del contexto. Este parámetro es obligatorio y no se puede establecer en NULL.
Valor devuelto
FltGetSectionContext devuelve STATUS_SUCCESS cuando devuelve correctamente el contexto de sección 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 volumen asociado a esta instancia no admite contextos de sección. 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.
FltGetSectionContext recupera un contexto de sección creado para una secuencia de archivos mediante una instancia de controlador de minifiltro especificada. Se crea un contexto de sección llamando a FltCreateSectionForDataScan.
FltGetSectionContext 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 FltGetSectionContext debe coincidir con una llamada posterior a FltReleaseContext.
Para asignar un nuevo contexto, llame a FltAllocateContext.
Los minifiltros no deben eliminar explícitamente un contexto de sección pasado a FltCreateSectionForDataScan. Un contexto de sección se desasigna y quita de una secuencia llamando a FltCloseSectionForDataScan en este caso.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Plataforma de destino | Universal |
| Encabezado | fltkernel.h (incluya Fltkernel.h) |
| Library | FltMgr.lib |
| Archivo DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |