# GrallocFuncs ## **概述** **所属模块:** [Display](_display.md) ## **汇总** ## Public 属性

Public 属性	描述
( AllocMem )(const AllocInfo info, BufferHandle *handle)	显示内存分配。更多...
( FreeMem )(BufferHandle *handle)	显示内存释放。更多...
( Mmap )(BufferHandle *handle)	显示内存映射，将内存映射到对应的进程地址空间中。更多...
( MmapYUV )(BufferHandle handle, YUVDescInfo info)	YUV 内存映射。更多...
( MmapCache )(BufferHandle *handle)	显示内存映射，将内存映射为 cache 内存到对应的进程地址空间中。更多...
( Unmap )(BufferHandle *handle)	内存反映射，将内存进行反映射。更多...
( FlushCache )(BufferHandle *handle)	刷新cache，刷新cache里的内容到内存并且使cache里的内容无效。更多...
( FlushMCache )(BufferHandle *handle)	刷新Mmap映射的cache，刷新Mmap映射的cache里的内容到内存并且使cache里的内容无效。更多...
( InvalidateCache )(BufferHandle *handle)	使cache中的内容无效用以存储更新内存内容。更多...
( IsSupportedAlloc )(uint32_t num, const VerifyAllocInfo infos, bool supporteds)	检测给定的VerifyAllocInfo数组信息能否申请内存成功。更多...

## **详细描述** 显示内存驱动接口结构体，定义显示内存驱动接口函数指针。 ## **类成员变量说明** ## AllocMem ``` int32_t(* GrallocFuncs::AllocMem) (const AllocInfo *info, BufferHandle **handle) ``` **描述：** 显示内存分配。根据GUI图形系统传递的参数分配内存，分配的内存根据类型可分为共享内存、cache内存和非cache内存等。 **参数：**

名称	描述
info	输入参数，指示申请内存AllocInfo信息.
handle	输入参数，指向申请的内存handle指针。

**返回：** DISPLAY\_SUCCESS 表示执行成功。其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#ga12a925dadef7573cd74d63d06824f9b0)。 ## FlushCache ``` int32_t(* GrallocFuncs::FlushCache) (BufferHandle *handle) ``` **描述：** 刷新cache，刷新cache里的内容到内存并且使cache里的内容无效。 **参数：**

名称	描述
handle	输出参数，待刷新cache的handle指针。

**返回：** DISPLAY\_SUCCESS 表示执行成功。其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#ga12a925dadef7573cd74d63d06824f9b0)。 ## FlushMCache ``` int32_t(* GrallocFuncs::FlushMCache) (BufferHandle *handle) ``` **描述：** 刷新Mmap映射的cache，刷新Mmap映射的cache里的内容到内存并且使cache里的内容无效。 **参数：**

名称	描述
handle	输出参数，待刷新cache的handle指针。

**返回：** DISPLAY\_SUCCESS 表示执行成功。其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#ga12a925dadef7573cd74d63d06824f9b0)。 ## FreeMem ``` void(* GrallocFuncs::FreeMem) (BufferHandle *handle) ``` **描述：** 显示内存释放。 **参数：**

名称	描述
handle	输入参数，待释放的内存handle指针。

**返回：** 成功返回有效地址，失败返回NULL。 ## InvalidateCache ``` int32_t(* GrallocFuncs::InvalidateCache) (BufferHandle *handle) ``` **描述：** 使cache中的内容无效用以存储更新内存内容。 **参数：**

名称	描述
handle	输出参数，待无效cache的handle指针。

**返回：** DISPLAY\_SUCCESS 表示执行成功。其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#ga12a925dadef7573cd74d63d06824f9b0)。 ## IsSupportedAlloc ``` int32_t(* GrallocFuncs::IsSupportedAlloc) (uint32_t num, const VerifyAllocInfo *infos, bool *supporteds) ``` **描述：** 检测给定的VerifyAllocInfo数组信息能否申请内存成功。 **参数：**

名称	描述
num	输入参数，VerifyAllocInfo数组个数。
infos	输出参数，VerifyAllocInfo数组首地址。
supporteds	输出参数，supporteds数组首地址, 表示能否申请成功。

**返回：** DISPLAY\_SUCCESS 表示执行成功。其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#ga12a925dadef7573cd74d63d06824f9b0)。 ## Mmap ``` void*(* GrallocFuncs::Mmap) (BufferHandle *handle) ``` **描述：** 显示内存映射，将内存映射到对应的进程地址空间中。 **参数：**

名称	描述
handle	输入参数，待映射内存handle指针。

**返回：** 成功返回有效地址，失败返回NULL。 ## MmapCache ``` void*(* GrallocFuncs::MmapCache) (BufferHandle *handle) ``` **描述：** 显示内存映射，将内存映射为 cache 内存到对应的进程地址空间中。 **参数：**

名称	描述
handle	输出参数，待映射内存 handle 指针。

**返回：** 成功返回有效地址，失败返回 NULL。 ## MmapYUV ``` void*(* GrallocFuncs::MmapYUV) (BufferHandle *handle, YUVDescInfo *info) ``` **描述：** YUV 内存映射。 **参数：**

名称	描述
handle	输出参数，指示内存映射的输出缓存。
info	输出参数，指示内存映射的YUVDescInfo信息。

**返回：** 成功返回有效地址，失败返回 NULL。 ## Unmap ``` int32_t(* GrallocFuncs::Unmap) (BufferHandle *handle) ``` **描述：** 内存反映射，将内存进行反映射。 **参数：**

名称	描述
handle	输出参数，待反映射内存handle指针。

**返回：** DISPLAY\_SUCCESS 表示执行成功。其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#ga12a925dadef7573cd74d63d06824f9b0)。