PsReturnPoolQuota-Funktion (ntifs.h)

  • Artikel

Die PsReturnPoolQuota-Routine gibt das Poolkontingent des angegebenen Pooltyps an den angegebenen Prozess zurück.

Syntax

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

Parameter

[in] Process

Zeiger auf den Prozess, dessen Kontingent zurückgegeben werden soll.

[in] PoolType

Typ des zurückzugebenden Poolkontingents, der wie folgt aussehen kann:

  • NonPagedPool
  • PagedPool
  • NonPagedPoolCacheAligned
  • PagedPoolCacheAligned

Die Pooltypen NonPagedPoolMustSucceed und NonPagedPoolCacheAlignedMustS sind veraltet und sollten nicht mehr verwendet werden.

[in] Amount

Anzahl der Bytes, die für diesen Prozess an das Poolkontingent zurückgegeben werden sollen.

Rückgabewert

Keine

Bemerkungen

Wenn die Kontingentrückgabe das Kontingent für den Prozess überschreiten würde, löst PsReturnPoolQuota eine Ausnahme mit dem status Wert STATUS_QUOTA_EXCEEDED aus. Aufrufer sind für die Behandlung dieser Ausnahme verantwortlich. Daher müssen Aufrufe von PsReturnPoolQuota innerhalb eines vom Treiber bereitgestellten Ausnahmehandlers umschlossen werden.

Jeder erfolgreiche Aufruf von PsChargePoolQuota muss durch einen nachfolgenden Aufruf von PsReturnPoolQuota abgeglichen werden.

Weitere Informationen zur Speicherverwaltung finden Sie unter Speicherverwaltung.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header ntifs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Weitere Informationen

PsChargePoolQuota