FLT_PARAMETERS para união IRP_MJ_QUERY_QUOTA
Componente union usado quando o campo MajorFunction da estrutura de FLT_IO_PARAMETER_BLOCK para a operação é IRP_MJ_QUERY_QUOTA.
Sintaxe
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;
Membros
QueryQuota: estrutura que contém os seguintes membros.
Comprimento: comprimento, em bytes, do buffer para o qual o QuotaBuffer aponta.
StartSid: ponteiro opcional para o SID (identificador de segurança) da entrada na qual iniciar a verificação da lista de cotas. Esse parâmetro será ignorado se o sinalizador SL_INDEX_SPECIFIED não estiver definido na estrutura FLT_IO_PARAMETER_BLOCK para a operação ou se SidList apontar para uma lista não íntegra.
SidList: ponteiro para um buffer de entrada estruturado FILE_GET_QUOTA_INFORMATION fornecido pelo chamador especificando os SIDs cujas informações de cota devem ser consultadas.
SidListLength: comprimento, em bytes, do buffer para o qual SidList aponta.
QuotaBuffer: ponteiro para um buffer de saída FILE_QUOTA_INFORMATION estruturado pelo chamador em que as informações de cota devem ser retornadas. Esse membro é opcional e pode ser NULL se um MDL for fornecido em MdlAddress. Veja os Comentários.
MdlAddress: endereço de uma MDL (lista de descritores de memória) que descreve o buffer para o qual o QuotaBuffer aponta. Esse membro é opcional e pode ser NULL se um buffer for fornecido no QuotaBuffer. Veja os Comentários.
Comentários
A estrutura FLT_PARAMETERS para operações de IRP_MJ_QUERY_QUOTA contém os parâmetros de uma operação de consulta-cota-informação baseada em IRP 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 que está sendo acessado no contexto do processo de chamada ou se é um endereço no modo kernel.
Se um minifiltro alterar o valor de MdlAddress, após o retorno de chamada pós-operação, o Gerenciador de Filtros liberará o MDL armazenado atualmente em MdlAddress e restaurará o valor anterior de MdlAddress.
IRP_MJ_QUERY_QUOTA é uma operação baseada em IRP.
Requisitos
| Tipo de Requisito | Requisito |
|---|---|
| parâmetro | Fltkernel.h (inclua Fltkernel.h) |