PsReturnPoolQuota-Funktion (ntifs.h)
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 |