GrallocFuncs

概述

显示内存驱动接口结构体,定义显示内存驱动接口函数指针。

相关模块:

Display

汇总

Public 属性

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

类成员变量说明

AllocMem

int32_t(* GrallocFuncs::AllocMem) (const AllocInfo *info, BufferHandle **handle)

描述:

显示内存分配。

根据GUI图形系统传递的参数分配内存,分配的内存根据类型可分为共享内存、cache内存和非cache内存等。

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败,具体错误码查看DispErrCode

FlushCache

int32_t(* GrallocFuncs::FlushCache) (BufferHandle *handle)

描述:

刷新cache,刷新cache里的内容到内存并且使cache里的内容无效。

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败,具体错误码查看DispErrCode

FlushMCache

int32_t(* GrallocFuncs::FlushMCache) (BufferHandle *handle)

描述:

刷新Mmap映射的cache,刷新Mmap映射的cache里的内容到内存并且使cache里的内容无效。

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败,具体错误码查看DispErrCode

FreeMem

void(* GrallocFuncs::FreeMem) (BufferHandle *handle)

描述:

显示内存释放。

参数:

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

返回:

成功返回有效地址,失败返回NULL。

InvalidateCache

int32_t(* GrallocFuncs::InvalidateCache) (BufferHandle *handle)

描述:

使cache中的内容无效用以存储更新内存内容。

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败,具体错误码查看DispErrCode

IsSupportedAlloc

int32_t(* GrallocFuncs::IsSupportedAlloc) (uint32_t num, const VerifyAllocInfo *infos, bool *supporteds)

描述:

检测给定的VerifyAllocInfo数组信息能否申请内存成功。

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败,具体错误码查看DispErrCode

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