1# NativeVsync 2 3 4提供NativeVsync功能。 5 6 7@syscap SystemCapability.Graphic.Graphic2D.NativeVsync 8 9 10**起始版本：** 11 12 138 14 15 16## 汇总 17 18 19### 文件 20 21| 文件名称 | 描述 | 22| -------- | -------- | 23| [native_vsync.h](native__vsync_8h.md) | 定义获取和使用NativeVsync的相关函数<br>引用文件：<native_vsync/native_vsync.h> | 24 25 26### 函数 27 28| 函数名称 | 描述 | 29| -------- | -------- | 30| [OH_NativeVSync_Create](#oh_nativevsync_create) (const char \*name, unsigned int length) | 创建一个OH_NativeVSync实例，每次调用都会产生一个新的实例 | 31| [OH_NativeVSync_Destroy](#oh_nativevsync_destroy) (OH_NativeVSync \*nativeVsync) | 销毁OH_NativeVSync实例 | 32| [OH_NativeVSync_RequestFrame](#oh_nativevsync_requestframe) (OH_NativeVSync \*nativeVsync, OH_NativeVSync_FrameCallback callback, void \*data) | 请求下一次vsync信号，当信号到来时，调用回调函数callback | 33 34 35## 详细描述 36 37 38## 函数说明 39 40 41### OH_NativeVSync_Create() 42 43 44``` 45OH_NativeVSync* OH_NativeVSync_Create (const char * name, unsigned int length ) 46``` 47 48**描述：** 49 50创建一个OH_NativeVSync实例，每次调用都会产生一个新的实例 51 52@syscap SystemCapability.Graphic.Graphic2D.NativeVsync 53 54**参数：** 55 56| Name | 描述 | 57| -------- | -------- | 58| name | 参数表示一个vsync连接的名字 | 59| length | 参数是name的长度 | 60 61**返回：** 62 63返回一个指向OH_NativeVSync实例的指针 64 65**起始版本：** 66 678 68 69 70### OH_NativeVSync_Destroy() 71 72 73``` 74void OH_NativeVSync_Destroy (OH_NativeVSync * nativeVsync) 75``` 76 77**描述：** 78 79销毁OH_NativeVSync实例 80 81@syscap SystemCapability.Graphic.Graphic2D.NativeVsync 82 83**参数：** 84 85| Name | 描述 | 86| -------- | -------- | 87| nativeVsync | 参数是一个指向OH_NativeVSync实例的指针 | 88 89**起始版本：** 90 918 92 93 94### OH_NativeVSync_RequestFrame() 95 96 97``` 98int OH_NativeVSync_RequestFrame (OH_NativeVSync * nativeVsync, OH_NativeVSync_FrameCallback callback, void * data ) 99``` 100 101**描述：** 102 103请求下一次vsync信号，当信号到来时，调用回调函数callback 104 105@syscap SystemCapability.Graphic.Graphic2D.NativeVsync 106 107**参数：** 108 109| Name | 描述 | 110| -------- | -------- | 111| nativeVsync | 参数是一个指向OH_NativeVSync实例的指针 | 112| callback | 参数是一个OH_NativeVSync_FrameCallback类型的函数指针，当下一次vsync信号到来时会被调用 | 113| data | 参数是一个指向用户自定义数据结构的指针，类型是void\* | 114 115**返回：** 116 117返回一个由GSError定义的int32_t类型的错误码 118 119**起始版本：** 120 1218 122