1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
/**
* @namespace biewlib
* @file biewlib/pmalloc.h
* @brief This file contains prototypes of preemptive memory allocation technology.
* @version -
* @remark this source file is part of Binary vIEW project (BIEW).
* The Binary vIEW (BIEW) is copyright (C) 1995 Nick Kurshev.
* All rights reserved. This software is redistributable under the
* licence given in the file "Licence.en" ("Licence.ru" in russian
* translation) distributed in the BIEW archive.
* @note Requires POSIX compatible development system
*
* @author Nick Kurshev
* @since 1999
* @note Development, fixes and improvements
**/
#ifndef __PMALLOC_H
#define __PMALLOC_H 1
#include <stddef.h>
#ifndef __BIEWLIB_H
#include "biewlib/biewlib.h"
#endif
#ifdef __cplusplus
extern "C" {
#endif
/** Allocates memory object with given size.
* @return Pointer to allocated object or NULL if error occured
* @param obj_size specifies required size of object in bytes
* @note When memory is exhausted will call user specified
* functions for freeing unneeded memory.
* @see PRealloc PFree
**/
extern void * __FASTCALL__ PMalloc(size_t obj_size);
/** Reallocates memory object with new size.
* @return Pointer to reallocated object or NULL if error occured
* @param ptr specifies object to be reallocated
* @param obj_size specifies new size of object in bytes
* @note if new address will be assigned for
* realocated object, then contents will
* be preserved. When memory is exhausted
* will call user specified functions
* for freeing unneeded memory.
* @see PMalloc PFree
**/
extern void * __FASTCALL__ PRealloc(void *ptr,size_t obj_size);
/** Frees memory object.
* @return Pointer to reallocated object or NULL if error occured
* @param ptr specifies object to be reallocated
* @param obj_size specifies new size of object in bytes
* @note if new address will be assigned for
* realocated object, then contents will
* be preserved.
* @see PMalloc PRealloc
**/
extern void __FASTCALL__ PFree(void *ptr);
/** Huge version of PMalloc.
* @note For 16-bit application it works with
* huge memory objects, for 32-bit apps.
* it work same as PMalloc
* @see PMalloc
**/
extern void __HUGE__ * __FASTCALL__ PHMalloc(unsigned long obj_size);
/** Huge version of PRealloc.
* @note For 16-bit application it works with
* huge memory objects, for 32-bit apps.
* it work same as PRealloc
* @see PRealloc
**/
extern void __HUGE__ * __FASTCALL__ PHRealloc(void __HUGE__ *ptr,unsigned long obj_size);
/** Huge version of PFree.
* @note For 16-bit application it works with
* huge memory objects, for 32-bit apps.
* it work same as PFree
* @see PFree
**/
extern void __FASTCALL__ PHFree(void __HUGE__ * ptr);
/** Frees pointer and nullifies it */
#define PFREE(ptr) { PFree(ptr); ptr = 0; }
/** Huge version of PFREE */
#define PHFREE(ptr) { PHFree(ptr); ptr = 0; }
/** Pointer to a user supplied function that freed unneeded memory.
* @return True if part of required memory is free.
* @param need_mem specifies size of needed memory
**/
typedef tBool (__FASTCALL__ *LowMemCallBack)(unsigned long need_mem);
/** Registers user-defined callback.
* @return True if foperation performed successfully
* @param func specifies user-defined callback function
* @see PMUnregLowMemCallBack
**/
extern tBool __FASTCALL__ PMRegLowMemCallBack(LowMemCallBack func);
/** Unregisters user-defined callback.
* @return True if foperation performed successfully
* @param func specifies user-defined callback function
* @see PMRegLowMemCallBack
**/
extern tBool __FASTCALL__ PMUnregLowMemCallBack(LowMemCallBack func);
#ifdef __cplusplus
}
#endif
#endif
|
