IFSMgr_RegisterHeapUser


IFSMgr_RegisterHeapUser(
 pIFSFunc pheapfunc,
 unsigned long flag
 )

This service registers a heap reclamation routine with the IFS manager. The IFS manager provides heap allocation services to the FSDs. An FSD that uses the heap services provided by the IFS manager can register a heap reclamation routine with the IFS manager that is called to free unused heap allocations. This service is not valid until the IFS manager performs Sys_Critical_Init during initialization. If the IFS manager is unable to add this user to the heap registry, it returns without indicating any error. All this means is that the heap cleaning routine for this user will never be called and it is not a serious failure.

pheapfunc

Supplies pointer to FSD heap reclamation routine.

flag

Supplies options available only under the debug version. The flag value is ignored in the retail version.

Flag Values:

Value

Meaning

DEBUG_FENCE_ON

This enables checking heap overruns in the debug version. If an heap overrun is detected, it breaks into the debugger.