FLT_PARAMETERS de unión de IRP_MJ_QUERY_EA

Artículo
03/14/2023

Componente de unión usado cuando se IRP_MJ_QUERY_EA el campo MajorFunction de la estructura de FLT_IO_PARAMETER_BLOCK para la operación.

Sintaxis

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG                    Length;
    PVOID                    EaList;
    ULONG                    EaListLength;
    ULONG  POINTER_ALIGNMENT EaIndex;
    PVOID                    EaBuffer;
    PMDL                     MdlAddress;
  } QueryEa;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Miembros

QueryEa: estructura dentro de FLT_PARAMETERS unión que contiene los miembros siguientes.
Longitud: longitud, en bytes, del búfer al que apunta EaBuffer .
EaList: puntero a un búfer de entrada estructurado de FILE_GET_EA_INFORMATION proporcionado por el autor de la llamada que especifica los atributos extendidos que se van a consultar.
EaListLength: longitud, en bytes, del búfer al que apunta EaList .
EaIndex: índice de la entrada en la que se va a empezar a examinar la lista de atributos extendidos. Este parámetro se omite si la marca SL_INDEX_SPECIFIED no está establecida en la estructura FLT_IO_PARAMETER_BLOCK para la operación o si EaList apunta a una lista no vacía.
EaBuffer: puntero a un búfer de salida estructurado de FILE_FULL_EA_INFORMATION proporcionado por el autor de la llamada en el que se devolverán los valores de atributo extendidos. Este miembro es opcional y puede ser NULL si se proporciona una MDL en MdlAddress. Vea Comentarios.
MdlAddress: dirección de una lista de descriptores de memoria (MDL) que describe el búfer al que apunta EaBuffer . Este miembro es opcional y puede ser NULL si se proporciona un búfer en EaBuffer. Vea Comentarios.

Comentarios

La estructura de FLT_PARAMETERS para las operaciones de IRP_MJ_QUERY_EA contiene los parámetros de una operación de información de consulta extendida basada en IRP representada por una estructura de datos de devolución de llamada (FLT_CALLBACK_DATA). Se encuentra en una estructura FLT_IO_PARAMETER_BLOCK.

Si se proporciona un búfer EaBuffer y MdlAddress , se recomienda que los minifiltros usen mdl. La memoria a la que Apunta EaBuffer es válida cuando se accede a una dirección de modo de usuario dentro del contexto del proceso de llamada, o si es una dirección del modo kernel.

Si un minifiltro cambia el valor de MdlAddress, después de su devolución de llamada posterior a la operación, el Administrador de filtros liberará el MDL almacenado actualmente en MdlAddress y restaurará el valor anterior de MdlAddress.

IRP_MJ_QUERY_EA es una operación basada en IRP.