FLT_PARAMETERS para IRP_MJ_SET_QUOTA união

2025-04-10

Componente union usado quando o campo MajorFunction da estrutura de FLT_IO_PARAMETER_BLOCK para a operação é IRP_MJ_SET_QUOTA.

Sintaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG Length;
    PVOID QuotaBuffer;
    PMDL  MdlAddress;
  } SetQuota;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membros

SetQuota: estrutura que contém os seguintes membros.
Comprimento: comprimento, em bytes, do buffer ao qual o QuotaBuffer aponta.
QuotaBuffer: ponteiro para um buffer de entrada estruturado FILE_QUOTA_INFORMATION fornecido pelo chamador que contém as informações de cota a serem definidas. Esse membro é opcional e pode ser NULL se um MDL for fornecido no MdlAddress. Consulte Comentários.
MdlAddress: endereço de uma MDL (lista de descritores de memória) que descreve o buffer ao qual o QuotaBuffer aponta. Esse membro é opcional e pode ser NULL se um buffer for fornecido no QuotaBuffer. Consulte Comentários.

Observações

A estrutura de FLT_PARAMETERS para operações de IRP_MJ_SET_QUOTA contém os parâmetros para uma operação set-quota-information representada por uma estrutura de dados de retorno de chamada (FLT_CALLBACK_DATA). Ele está contido em uma estrutura FLT_IO_PARAMETER_BLOCK.

Se um buffer QuotaBuffer e MdlAddress for fornecido, é recomendável que os minifiltros usem o MDL. A memória para a qual o QuotaBuffer aponta é válida quando é um endereço de modo de usuário sendo acessado dentro do contexto do processo de chamada ou se é um endereço de modo kernel.

Se um minifiltro alterar o valor de MdlAddress, depois de seu retorno de chamada pós-operação, o Gerenciador de Filtros liberará o MDL atualmente armazenado em MdlAddress e restaurará o valor anterior de MdlAddress.

IRP_MJ_SET_QUOTA é uma operação baseada em IRP.