Función FltGetVolumeContext (fltkernel.h)
La rutina de FltGetVolumeContext recupera un contexto establecido para un volumen por un controlador de minifiltro determinado.
Sintaxis
NTSTATUS FLTAPI FltGetVolumeContext(
[in] PFLT_FILTER Filter,
[in] PFLT_VOLUME Volume,
[out] PFLT_CONTEXT *Context
);
Parámetros
[in] Filter
Puntero de filtro opaco para el autor de la llamada. Este parámetro es necesario y no puede ser NULL.
[in] Volume
Puntero opaco para el volumen cuyo contexto se está recuperando. Este parámetro es necesario y no puede ser NULL.
[out] Context
Puntero a una variable asignada por el autor de la llamada que recibe la dirección del contexto solicitado. Este parámetro es necesario y no se puede establecer en NULL.
Valor devuelto
fltGetVolumeContext devuelve STATUS_SUCCESS cuando devuelve correctamente el contexto 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 este archivo en este momento, por lo que FltMgr establezca Context en NULL_CONTEXT. Se trata de un código de error. |
Observaciones
Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.
FltGetVolumeContext incrementa el recuento de referencias en el contexto al que apunta el parámetro Context de. 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 fltGetVolumeContext debe coincidir con una llamada posterior a FltReleaseContext.
Para establecer un contexto para un volumen, llame a FltSetVolumeContext.
Para asignar un nuevo contexto, llame a FltAllocateContext.
Para eliminar un contexto de volumen, llame a FltDeleteVolumeContext o FltDeleteContext.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | fltkernel.h (incluya Fltkernel.h) |
| biblioteca de | FltMgr.lib |
| DLL de | Fltmgr.sys |
| irQL | <= APC_LEVEL |