# GrallocFuncs


## **概述**

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

**相关模块:**

[Display](_display.md)


## **汇总**


### Public 属性

  | 名称 | 描述 | 
| -------- | -------- |
| ([AllocMem](#allocmem))(const AllocInfo \*info, BufferHandle \*\*handle) | 显示内存分配。 | 
| ([FreeMem](#freemem))(BufferHandle \*handle) | 显示内存释放。 | 
| ([Mmap](#mmap))(BufferHandle \*handle) | 显示内存映射，将内存映射到对应的进程地址空间中。 | 
| ([MmapYUV](#mmapyuv))(BufferHandle \*handle, YUVDescInfo \*info) | YUV 内存映射。 | 
| ([MmapCache](#mmapcache))(BufferHandle \*handle) | 显示内存映射，将内映射为cache内存到对应的进程地址空间中。 | 
| ([Unmap](#unmap))(BufferHandle \*handle) | 内存反映射，将内存进行反映射。 | 
| ([FlushCache](#flushcache))(BufferHandle \*handle) | 刷新cache，刷新cache里的内容到内存并且使cache里的内容无效。 | 
| ([FlushMCache](#flushmcache))(BufferHandle \*handle) | 刷新Mmap映射的cache，刷新Mmap映射的cache里的内容到内存并且使cache里的内容无效。 | 
| ([InvalidateCache](#invalidatecache))(BufferHandle \*handle) | 使cache中的内容无效用以存储更新内存内容。 | 
| ([IsSupportedAlloc](#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#disperrcode)。


### FlushCache

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

**描述：**

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

**参数:**

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

**返回:**

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#disperrcode)。


### FlushMCache

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

**描述：**

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

**参数:**

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

**返回:**

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#disperrcode)。


### 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#disperrcode)。


### IsSupportedAlloc

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

**描述：**

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

**参数:**

  | 名称 | 描述 | 
| -------- | -------- |
| num | 输入参数，[VerifyAllocInfo](_verify_alloc_info.md)数组个数。 | 
| infos | 输出参数，[VerifyAllocInfo](_verify_alloc_info.md)数组首地址。 | 
| supporteds | 输出参数，supporteds数组首地址, 表示能否申请成功。 | 

**返回:**

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#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](_yun_desc_info_.md)信息。 | 

**返回:**

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


### Unmap

  
```
int32_t(* GrallocFuncs::Unmap) (BufferHandle *handle)
```

**描述：**

内存反映射，将内存进行反映射。

**参数:**

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

**返回:**

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看[DispErrCode](_display.md#disperrcode)。