cmnMemory.h revision 956c553ab0ce72f8074ad0fda2ffd66a0305700c
1/*
2 ** Copyright 2003-2010, VisualOn, Inc.
3 **
4 ** Licensed under the Apache License, Version 2.0 (the "License");
5 ** you may not use this file except in compliance with the License.
6 ** You may obtain a copy of the License at
7 **
8 **     http://www.apache.org/licenses/LICENSE-2.0
9 **
10 ** Unless required by applicable law or agreed to in writing, software
11 ** distributed under the License is distributed on an "AS IS" BASIS,
12 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 ** See the License for the specific language governing permissions and
14 ** limitations under the License.
15 */
16/*******************************************************************************
17	File:		cmnMemory.h
18
19	Content:	memory operator implementation header file
20
21*******************************************************************************/
22
23#ifndef __cmnMemory_H__
24#define __cmnMemory_H__
25
26#ifdef __cplusplus
27extern "C" {
28#endif /* __cplusplus */
29
30#include <voMem.h>
31
32//extern VO_MEM_OPERATOR	g_memOP;
33
34/**
35 * Allocate memory
36 * \param uID [in] module ID
37 * \param uSize [in] size of memory
38 * \return value is the allocated memory address. NULL is failed.
39 */
40VO_U32	cmnMemAlloc (VO_S32 uID,  VO_MEM_INFO * pMemInfo);
41
42/**
43 * Free up memory
44 * \param uID [in] module ID
45 * \param pMem [in] address of memory
46 * \return value 0, if succeeded.
47 */
48VO_U32	cmnMemFree (VO_S32 uID, VO_PTR pBuffer);
49
50/**
51 * memory set function
52 * \param uID [in] module ID
53 * \param pBuff [in/out] address of memory
54 * \param uValue [in] the value to be set
55 * \param uSize [in] the size to be set
56 * \return value 0, if succeeded.
57 */
58VO_U32	cmnMemSet (VO_S32 uID, VO_PTR pBuff, VO_U8 uValue, VO_U32 uSize);
59
60/**
61 * memory copy function
62 * \param uID [in] module ID
63 * \param pDest [in/out] address of destination memory
64 * \param pSource [in] address of source memory
65 * \param uSize [in] the size to be copied
66 * \return value 0, if succeeded.
67 */
68VO_U32	cmnMemCopy (VO_S32 uID, VO_PTR pDest, VO_PTR pSource, VO_U32 uSize);
69
70/**
71 * memory check function
72 * \param uID [in] module ID
73 * \param pBuff [in] address of buffer to be checked
74 * \param uSize [in] the size to be checked
75 * \return value 0, if succeeded.
76 */
77VO_U32	cmnMemCheck (VO_S32 uID, VO_PTR pBuffer, VO_U32 uSize);
78
79/**
80 * memory compare function
81 * \param uID [in] module ID
82 * \param pBuffer1 [in] address of buffer 1 to be compared
83 * \param pBuffer2 [in] address of buffer 2 to be compared
84 * \param uSize [in] the size to be compared
85 * \return value: same as standard C run-time memcmp() function.
86 */
87VO_S32	cmnMemCompare (VO_S32 uID, VO_PTR pBuffer1, VO_PTR pBuffer2, VO_U32 uSize);
88
89/**
90 * memory move function
91 * \param uID [in] module ID
92 * \param pDest [in/out] address of destination memory
93 * \param pSource [in] address of source memory
94 * \param uSize [in] the size to be moved
95 * \return value 0, if succeeded.
96 */
97VO_U32	cmnMemMove (VO_S32 uID, VO_PTR pDest, VO_PTR pSource, VO_U32 uSize);
98
99
100#ifdef __cplusplus
101}
102#endif /* __cplusplus */
103
104#endif // __cmnMemory_H__
105
106
107