FLT_PARAMETERS para la unión de IRP_MJ_QUERY_QUOTA

Artículo
03/14/2023

Componente de unión que se usa cuando se IRP_MJ_QUERY_QUOTA el campo MajorFunction de la estructura de FLT_IO_PARAMETER_BLOCK para la operación.

Sintaxis

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG                       Length;
    PSID                        StartSid;
    PFILE_GET_QUOTA_INFORMATION SidList;
    ULONG                       SidListLength;
    PVOID                       QuotaBuffer;
    PMLD                        MdlAddress;
  } QueryQuota;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Miembros

QueryQuota: estructura que contiene los siguientes miembros.
Longitud: longitud, en bytes, del búfer al que Apunta QuotaBuffer .
StartSid: puntero opcional al identificador de seguridad (SID) de la entrada en la que se va a comenzar a examinar la lista de cuotas. Este parámetro se omite si la marca de SL_INDEX_SPECIFIED no está establecida en la estructura de FLT_IO_PARAMETER_BLOCK para la operación o si SidList apunta a una lista no vacía.
SidList: puntero a un búfer de entrada estructurado de FILE_GET_QUOTA_INFORMATION proporcionado por el autor de la llamada que especifica los SID cuya información de cuota se va a consultar.
SidListLength: longitud, en bytes, del búfer al que apunta SidList .
QuotaBuffer: puntero a un búfer de salida estructurado de FILE_QUOTA_INFORMATION proporcionado por el autor de la llamada donde se va a devolver la información de cuota. 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 QuotaBuffer . Este miembro es opcional y puede ser NULL si se proporciona un búfer en QuotaBuffer. Vea Comentarios.

Comentarios

La estructura FLT_PARAMETERS para las operaciones de IRP_MJ_QUERY_QUOTA contiene los parámetros de una operación de información de cuota de consulta 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 QuotaBuffer y MdlAddress , se recomienda que los minifiltros usen MDL. La memoria a la que QuotaBuffer apunta es válida cuando se accede a una dirección de modo de usuario en el contexto del proceso de llamada, o si es una dirección de 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_QUOTA es una operación basada en IRP.