estructura FLT_CONTEXT_REGISTRATION (fltkernel.h)

Artículo
08/07/2023

La estructura FLT_CONTEXT_REGISTRATION se usa para registrar tipos de contexto.

Sintaxis

typedef struct _FLT_CONTEXT_REGISTRATION {
  FLT_CONTEXT_TYPE               ContextType;
  FLT_CONTEXT_REGISTRATION_FLAGS Flags;
  PFLT_CONTEXT_CLEANUP_CALLBACK  ContextCleanupCallback;
  SIZE_T                         Size;
  ULONG                          PoolTag;
  PFLT_CONTEXT_ALLOCATE_CALLBACK ContextAllocateCallback;
  PFLT_CONTEXT_FREE_CALLBACK     ContextFreeCallback;
  PVOID                          Reserved1;
} FLT_CONTEXT_REGISTRATION, *PFLT_CONTEXT_REGISTRATION;

Miembros

ContextType

Tipo de contexto. Este miembro es obligatorio y debe ser uno de los siguientes valores:

FLT_FILE_CONTEXT (solo Windows Vista y versiones posteriores).

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (solo Windows 8 y versiones posteriores).

FLT_TRANSACTION_CONTEXT (solo Windows Vista y versiones posteriores).

FLT_VOLUME_CONTEXT

Flags

Máscara de bits de marcas que especifican cómo el administrador de filtros asigna un nuevo contexto a partir de una lista de contextos de tamaño fijo. Este miembro puede ser cero o el siguiente valor.

Marca	Significado
FLTFL_CONTEXT_REGISTRATION_NO_EXACT_SIZE_MATCH	Si el minifiltro usa contextos de tamaño fijo y se especifica esta marca, el administrador de filtros asigna un contexto de la lista de aspecto si el tamaño del contexto de la lista de lookaside es mayor o igual que el tamaño solicitado. De lo contrario, el administrador de filtros asigna un contexto de la lista de aspecto solo si el tamaño del contexto de la lista de lookaside es igual al tamaño solicitado.

Marca

Significado

FLTFL_CONTEXT_REGISTRATION_NO_EXACT_SIZE_MATCH

Si el minifiltro usa contextos de tamaño fijo y se especifica esta marca, el administrador de filtros asigna un contexto de la lista de aspecto si el tamaño del contexto de la lista de lookaside es mayor o igual que el tamaño solicitado. De lo contrario, el administrador de filtros asigna un contexto de la lista de aspecto solo si el tamaño del contexto de la lista de lookaside es igual al tamaño solicitado.

ContextCleanupCallback

Puntero a una rutina ContextCleanupCallback definida por minifiltro de tipo PFLT_CONTEXT_CLEANUP_CALLBACK. El administrador de filtros llama a esta rutina inmediatamente antes de eliminar el contexto. Si el minifiltro no tiene memoria ni punteros para limpiar dentro del contexto, este miembro es opcional y puede ser NULL.

Size

Tamaño, en bytes, de la parte definida por minifiltro del contexto, si el minifiltro usa contextos de tamaño fijo. Cero es un valor de tamaño válido. Si el minifiltro usa contextos de tamaño variable, se requiere este miembro y debe establecerse en FLT_VARIABLE_SIZED_CONTEXTS.

PoolTag

Valor de etiqueta de grupo que se usará para el contexto. Esta etiqueta, que se especifica como una cadena de uno a cuatro caracteres ASCII de 7 bits, aparece en cualquier volcado de memoria del sistema que se produzca. Si el miembro ContextAllocateCallback es NULL, este miembro es obligatorio y no puede ser cero.

ContextAllocateCallback

Puntero a una rutina ContextAllocateCallback definida por minifiltro de tipo PFLT_CONTEXT_ALLOCATE_CALLBACK. Este miembro es opcional y puede ser NULL. Si no es NULL, se omiten los miembros Size y PoolTag .

ContextFreeCallback

Puntero a una rutina ContextFreeCallback definida por minifiltro de tipo PFLT_CONTEXT_FREE_CALLBACK. Este miembro es opcional y puede ser NULL. Si no es NULL, se omiten los miembros Size y PoolTag .

Reserved1

Reservado para uso del sistema. Los minifiltros deben establecer este miembro en NULL.

Comentarios

Cuando un minifiltro llama a FltRegisterFilter desde su rutina DriverEntry , debe registrar cada tipo de contexto que use.

Para registrar estos tipos de contexto, el minifiltro crea una matriz de longitud variable de FLT_CONTEXT_REGISTRATION estructuras y almacena un puntero a la matriz en el miembro ContextRegistration de la estructura FLT_REGISTRATION que el minifiltro pasa como parámetro Registration de FltRegisterFilter. El último elemento de esta matriz debe ser {FLT_CONTEXT_END}.

Para cada tipo de contexto que use el minifiltro, el minifiltro debe proporcionar al menos una estructura de FLT_CONTEXT_REGISTRATION, según las reglas siguientes:

Si el minifiltro proporciona una estructura de FLT_CONTEXT_REGISTRATION con un miembro ContextAllocateCallback distinto de NULL, no puede proporcionar estructuras FLT_CONTEXT_REGISTRATION adicionales para ese tipo de contexto.
Si el minifiltro proporciona dos o más estructuras de FLT_CONTEXT_REGISTRATION idénticas, solo se usará la primera. Los demás se omitirán.
Solo se puede proporcionar una estructura FLT_CONTEXT_REGISTRATION con un miembro Size de FLT_VARIABLE_SIZED_CONTEXTS para cada tipo de contexto.
No se pueden proporcionar más de tres estructuras de FLT_CONTEXT_REGISTRATION con un miembro Size distinto de FLT_VARIABLE_SIZED_CONTEXTS para cada tipo de contexto.