Função PsChargePoolQuota (ntifs.h)

A rotina PsChargePoolQuota cobra a cota do pool do tipo de pool especificado para o processo especificado.

Sintaxe

void PsChargePoolQuota(
  [in] PEPROCESS Process,
  [in] POOL_TYPE PoolType,
  [in] ULONG_PTR Amount
);

Parâmetros

[in] Process

Ponteiro para o processo cuja cota deve ser cobrada.

[in] PoolType

Tipo de cota de pool a ser cobrada, que pode ser um dos seguintes:

• NonPagedPool
• PagedPool
• NonPagedPoolCacheAligned
• PagedPoolCacheAligned

Os tipos de pool NonPagedPoolMustSucceed e NonPagedPoolCacheAlignedMustS estão obsoletos e não devem mais ser usados.

[in] Amount

Número de bytes a serem cobrados pela cota do pool para esse processo.

Retornar valor

Nenhum

Comentários

Se houver cota insuficiente para o processo, a cota não será cobrada e PsChargePoolQuota gerará uma exceção com o valor status STATUS_QUOTA_EXCEEDED. Os chamadores são responsáveis por lidar com essa exceção. Portanto, as chamadas para PsChargePoolQuota devem ser encapsuladas em um manipulador de exceção fornecido pelo driver.

Cada chamada bem-sucedida para PsChargePoolQuota deve ser correspondida por uma chamada subsequente para PsReturnPoolQuota.

Para obter mais informações sobre o gerenciamento de memória, consulte Gerenciamento de memória.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Confira também

PsReturnPoolQuota