1# drawing_memory_stream.h 2 3<!--Kit: ArkGraphics 2D--> 4<!--Subsystem: Graphic--> 5<!--Owner: @hangmengxin--> 6<!--Designer: @wangyanglan--> 7<!--Tester: @nobuggers--> 8<!--Adviser: @ge-yafang--> 9 10## 概述 11 12文件中定义了与内存流相关的功能函数。 13 14**引用文件：** <native_drawing/drawing_memory_stream.h> 15 16**库：** libnative_drawing.so 17 18**起始版本：** 12 19 20**相关模块：** [Drawing](capi-drawing.md) 21 22## 汇总 23 24### 函数 25 26| 名称 | 描述 | 27| -- | -- | 28| [OH_Drawing_MemoryStream* OH_Drawing_MemoryStreamCreate(const void* data, size_t length, bool copyData)](#oh_drawing_memorystreamcreate) | 创建一个内存流对象。<br>本接口会产生错误码，可以通过[OH_Drawing_ErrorCodeGet](capi-drawing-error-code-h.md#oh_drawing_errorcodeget)查看错误码的取值。<br>data为NULL或者length等于0时返回OH_DRAWING_ERROR_INVALID_PARAMETER。 | 29| [void OH_Drawing_MemoryStreamDestroy(OH_Drawing_MemoryStream* memoryStream)](#oh_drawing_memorystreamdestroy) | 销毁内存流对象并回收该对象占有内存。 | 30 31## 函数说明 32 33### OH_Drawing_MemoryStreamCreate() 34 35``` 36OH_Drawing_MemoryStream* OH_Drawing_MemoryStreamCreate(const void* data, size_t length, bool copyData) 37``` 38 39**描述** 40 41创建一个内存流对象。<br>本接口会产生错误码，可以通过[OH_Drawing_ErrorCodeGet](capi-drawing-error-code-h.md#oh_drawing_errorcodeget)查看错误码的取值。<br>data为NULL或者length等于0时返回OH_DRAWING_ERROR_INVALID_PARAMETER。 42 43**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 44 45**起始版本：** 12 46 47 48**参数：** 49 50| 参数项 | 描述 | 51| -- | -- | 52| const void* data | 数据段。 | 53| size_t length | 数据段长度。 | 54| bool copyData | 是否拷贝数据。true表示内存流对象会拷贝一份数据段数据，false表示内存流对象直接使用数据段数据，不拷贝。 | 55 56**返回：** 57 58| 类型 | 说明 | 59| -- | -- | 60| [OH_Drawing_MemoryStream](capi-drawing-oh-drawing-memorystream.md)* | 函数会返回一个指针，指针指向创建的内存流对象[OH_Drawing_MemoryStream](capi-drawing-oh-drawing-memorystream.md)。 | 61 62### OH_Drawing_MemoryStreamDestroy() 63 64``` 65void OH_Drawing_MemoryStreamDestroy(OH_Drawing_MemoryStream* memoryStream) 66``` 67 68**描述** 69 70销毁内存流对象并回收该对象占有内存。 71 72**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 73 74**起始版本：** 12 75 76 77**参数：** 78 79| 参数项 | 描述 | 80| -- | -- | 81| [OH_Drawing_MemoryStream](capi-drawing-oh-drawing-memorystream.md)* memoryStream | 指向内存流对象[OH_Drawing_MemoryStream](capi-drawing-oh-drawing-memorystream.md)的指针。 | 82 83 84