Função PsReturnPoolQuota (ntifs.h)

A rotina PsReturnPoolQuota retorna a cota de pool do tipo de pool especificado para o processo especificado.

Sintaxe

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

Parâmetros

[in] Process

Ponteiro para o processo cuja cota deve ser retornada.

[in] PoolType

Tipo de cota de pool a ser retornada, 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 retornados à cota de pool para esse processo.

Retornar valor

Nenhum

Comentários

Se o retorno da cota exceder a cota do processo, PsReturnPoolQuota 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 PsReturnPoolQuota 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

Confira também

PsChargePoolQuota