__KHEAP_FAILNEXT

__KHEAP_FAILNEXT(aCount) User::__DbgSetAllocFail(RHeap::EKernel,RHeap::EFailNext,aCount)

Support

Supported from 5.0

Description

Simulates Kernel heap allocation failure. The failure occurs on the next call to new or any of the functions which allocate memory from the heap. This macro is defined only for debug builds.

Checking the Kernel heap is only useful when developing Kernel side code such as device drivers and media drivers.

Parameters

aCount The rate of failure - heap allocation fails every aCount attempt.

See also:

• User::__DbgSetAllocFail()