# GrallocFuncs


## **概述**

**所属模块:**

[Display](_display.md)


## **汇总**


### Public 属性

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


## **详细描述**

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


## **类成员变量说明**


### 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数组个数。 | 
| infos | 输出参数，VerifyAllocInfo数组首地址。 | 
| 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信息。 | 

**返回：**

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


### Unmap

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

**描述：**

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

**参数：**

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

**返回：**

DISPLAY_SUCCESS 表示执行成功。

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