1# NativeWindow 2 3 4## 概述 5 6提供NativeWindow功能，作为数据生产者，可用来和egl对接 7 8\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 9 10**起始版本:** 11 128 13 14 15## 汇总 16 17 18### 文件 19 20| 名称 | 描述 | 21| -------- | -------- | 22| [external_window.h](external__window_8h.md) | 定义获取和使用NativeWindow的相关函数<br/>引用文件：<native_window/external_window.h> <br/>库：libnative_window.so| 23 24 25### 结构体 26 27| 名称 | 描述 | 28| -------- | -------- | 29| [Region](_region.md) | 表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区） | 30| [OHHDRMetaData](_o_h_h_d_r_meta_data.md) | HDR元数据结构体定义 | 31| [OHExtDataHandle](_o_h_ext_data_handle.md) | 扩展数据句柄结构体定义 | 32 33 34### 类型定义 35 36| 名称 | 描述 | 37| -------- | -------- | 38| [OHNativeWindow](#ohnativewindow) | 提供对OHNativeWindow的访问功能 | 39| [OHNativeWindowBuffer](#ohnativewindowbuffer) | 提供对OHNativeWindowBuffer的访问功能 | 40| [Region](#region) | 表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区） | 41 42 43### 枚举 44 45| 名称 | 描述 | 46| -------- | -------- | 47| [NativeWindowOperation](#nativewindowoperation) {<br/>SET_BUFFER_GEOMETRY, GET_BUFFER_GEOMETRY, GET_FORMAT, SET_FORMAT,<br/>GET_USAGE, SET_USAGE, SET_STRIDE, GET_STRIDE,<br/>SET_SWAP_INTERVAL, GET_SWAP_INTERVAL, SET_TIMEOUT, GET_TIMEOUT,<br/>SET_COLOR_GAMUT, GET_COLOR_GAMUT, SET_TRANSFORM, GET_TRANSFORM,<br/>SET_UI_TIMESTAMP<br/>} | OH_NativeWindow_NativeWindowHandleOpt函数中的操作码 | 48| [OHScalingMode](#ohscalingmode) { OH_SCALING_MODE_FREEZE = 0, OH_SCALING_MODE_SCALE_TO_WINDOW, OH_SCALING_MODE_SCALE_CROP, OH_SCALING_MODE_NO_SCALE_CROP } | 缩放模式 Scaling Mode | 49| [OHHDRMetadataKey](#ohhdrmetadatakey) {<br/>OH_METAKEY_RED_PRIMARY_X = 0, OH_METAKEY_RED_PRIMARY_Y = 1, OH_METAKEY_GREEN_PRIMARY_X = 2, OH_METAKEY_GREEN_PRIMARY_Y = 3,<br/>OH_METAKEY_BLUE_PRIMARY_X = 4, OH_METAKEY_BLUE_PRIMARY_Y = 5, OH_METAKEY_WHITE_PRIMARY_X = 6, OH_METAKEY_WHITE_PRIMARY_Y = 7,<br/>OH_METAKEY_MAX_LUMINANCE = 8, OH_METAKEY_MIN_LUMINANCE = 9, OH_METAKEY_MAX_CONTENT_LIGHT_LEVEL = 10, OH_METAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL = 11,<br/>OH_METAKEY_HDR10_PLUS = 12, OH_METAKEY_HDR_VIVID = 13<br/>} | 枚举HDR元数据关键字 | 50 51 52### 函数 53 54| 名称 | 描述 | 55| -------- | -------- | 56| [OH_NativeWindow_CreateNativeWindow](#oh_nativewindow_createnativewindow) (void \*pSurface) | 创建OHNativeWindow实例，每次调用都会产生一个新的OHNativeWindow实例 | 57| [OH_NativeWindow_DestroyNativeWindow](#oh_nativewindow_destroynativewindow) (OHNativeWindow \*window) | 将OHNativeWindow对象的引用计数减1，当引用计数为0的时候，该OHNativeWindow对象会被析构掉 | 58| [OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer](#oh_nativewindow_createnativewindowbufferfromsurfacebuffer) (void \*pSurfaceBuffer) | 创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例 | 59| [OH_NativeWindow_DestroyNativeWindowBuffer](#oh_nativewindow_destroynativewindowbuffer) (OHNativeWindowBuffer \*buffer) | 将OHNativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该OHNativeWindowBuffer对象会被析构掉 | 60| [OH_NativeWindow_NativeWindowRequestBuffer](#oh_nativewindow_nativewindowrequestbuffer) (OHNativeWindow \*window, OHNativeWindowBuffer \*\*buffer, int \*fenceFd) | 通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产 | 61| [OH_NativeWindow_NativeWindowFlushBuffer](#oh_nativewindow_nativewindowflushbuffer) (OHNativeWindow \*window, OHNativeWindowBuffer \*buffer, int fenceFd, Region region) | 通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费 | 62| [OH_NativeWindow_NativeWindowAbortBuffer](#oh_nativewindow_nativewindowabortbuffer) (OHNativeWindow \*window, OHNativeWindowBuffer \*buffer) | 通过OHNativeWindow将之前申请出来的OHNativeWindowBuffer返还到Buffer队列中，供下次再申请 | 63| [OH_NativeWindow_NativeWindowHandleOpt](#oh_nativewindow_nativewindowhandleopt) (OHNativeWindow \*window, int code,...) | 设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等 | 64| [OH_NativeWindow_GetBufferHandleFromNative](#oh_nativewindow_getbufferhandlefromnative) (OHNativeWindowBuffer \*buffer) | 通过OHNativeWindowBuffer获取该buffer的BufferHandle指针 | 65| [OH_NativeWindow_NativeObjectReference](#oh_nativewindow_nativeobjectreference) (void \*obj) | 增加一个NativeObject的引用计数 | 66| [OH_NativeWindow_NativeObjectUnreference](#oh_nativewindow_nativeobjectunreference) (void \*obj) | 减少一个NativeObject的引用计数，当引用计数减少为0时，该NativeObject将被析构掉 | 67| [OH_NativeWindow_GetNativeObjectMagic](#oh_nativewindow_getnativeobjectmagic) (void \*obj) | 获取NativeObject的MagicId | 68| [OH_NativeWindow_NativeWindowSetScalingMode](#oh_nativewindow_nativewindowsetscalingmode) (OHNativeWindow \*window, uint32_t sequence, OHScalingMode scalingMode) | 设置OHNativeWindow的ScalingMode | 69| [OH_NativeWindow_NativeWindowSetMetaData](#oh_nativewindow_nativewindowsetmetadata) (OHNativeWindow \*window, uint32_t sequence, int32_t size, const OHHDRMetaData \*metaData) | 设置OHNativeWindow的元数据 | 70| [OH_NativeWindow_NativeWindowSetMetaDataSet](#oh_nativewindow_nativewindowsetmetadataset) (OHNativeWindow*window, uint32_t sequence, OHHDRMetadataKey key, int32_t size, const uint8_t \*metaData) | 设置OHNativeWindow的元数据集。 | 71| [OH_NativeWindow_NativeWindowSetTunnelHandle](#oh_nativewindow_nativewindowsettunnelhandle) (OHNativeWindow \*window, const OHExtDataHandle \*handle) | 设置OHNativeWindow的TunnelHandle。 | 72 73 74## 类型定义说明 75 76 77### OHNativeWindow 78 79 80``` 81typedef struct NativeWindow OHNativeWindow 82``` 83 84**描述:** 85 86提供对OHNativeWindow的访问功能 87 88 89### OHNativeWindowBuffer 90 91 92``` 93typedef struct NativeWindowBuffer OHNativeWindowBuffer 94``` 95 96**描述:** 97 98提供对OHNativeWindowBuffer的访问功能 99 100 101### Region 102 103 104``` 105typedef struct Region Region 106``` 107 108**描述:** 109 110表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区） 111 112 113## 枚举类型说明 114 115 116### NativeWindowOperation 117 118 119``` 120enum NativeWindowOperation 121``` 122 123**描述:** 124 125OH_NativeWindow_NativeWindowHandleOpt函数中的操作码 126 127| 枚举值 | 描述 | 128| -------- | -------- | 129| SET_BUFFER_GEOMETRY | 设置本地窗口缓冲区几何图形， 函数中的可变参数是 [输入]int32_t width ，[输入] int32_t height。 | 130| GET_BUFFER_GEOMETRY | 获取本地窗口缓冲区几何图形， 函数中的可变参数是 [输出] int32_t \*height， [输出] int32_t \*width。 | 131| GET_FORMAT | 获取本地窗口缓冲区格式， 函数中的可变参数是 [输出] int32_t \*format。 | 132| SET_FORMAT | 设置本地窗口缓冲区格式， 函数中的可变参数是 [输入] int32_t format。 | 133| GET_USAGE | 获取本地窗口读写方式， 函数中的可变参数是 [输出] int32_t \*usage。 | 134| SET_USAGE | 设置本地窗口缓冲区读写方式， 函数中的可变参数是 [输入] int32_t usage。 | 135| SET_STRIDE | 设置本地窗口缓冲区步幅， 函数中的可变参数是 [输入] int32_t stride。 | 136| GET_STRIDE | 获取本地窗口缓冲区步幅， 函数中的可变参数是 [输出] int32_t \*stride。 | 137| SET_SWAP_INTERVAL | 设置本地窗口缓冲区交换间隔， 函数中的可变参数是 [输入] int32_t interval。 | 138| GET_SWAP_INTERVAL | 获取本地窗口缓冲区交换间隔， 函数中的可变参数是 [输出] int32_t \*interval。 | 139| SET_TIMEOUT | 设置请求本地窗口缓冲区的超时等待时间， 函数中的可变参数是 [输入] int32_t timeout。 | 140| GET_TIMEOUT | 获取请求本地窗口缓冲区的超时等待时间， 函数中的可变参数是 [输出] int32_t \*timeout。 | 141| SET_COLOR_GAMUT | 设置本地窗口缓冲区色彩空间， 函数中的可变参数是 [输入] int32_t colorGamut。 | 142| GET_COLOR_GAMUT | 获取本地窗口缓冲区色彩空间， 函数中的可变参数是 [out int32_t \*colorGamut]。 | 143| SET_TRANSFORM | 设置本地窗口缓冲区变换， 函数中的可变参数是 [输入] int32_t transform。 | 144| GET_TRANSFORM | 获取本地窗口缓冲区变换， 函数中的可变参数是 [输出] int32_t \*transform。 | 145| SET_UI_TIMESTAMP | 设置本地窗口缓冲区UI时间戳， 函数中的可变参数是 [输入] uint64_t uiTimestamp。 | 146 147 148### OHHDRMetadataKey 149 150 151``` 152enum OHHDRMetadataKey 153``` 154 155**描述:** 156 157枚举HDR元数据关键字 158 159**起始版本:** 160 1619 162 163**弃用:** 164 165从API version 10开始废弃，不再提供替代接口 166 167| 枚举值 | 描述 | 168| -------- | -------- | 169| OH_METAKEY_RED_PRIMARY_X | 红基色X坐标 | 170| OH_METAKEY_RED_PRIMARY_Y | 红基色Y坐标 | 171| OH_METAKEY_GREEN_PRIMARY_X | 绿基色X坐标 | 172| OH_METAKEY_GREEN_PRIMARY_Y | 绿基色Y坐标 | 173| OH_METAKEY_BLUE_PRIMARY_X | 蓝基色X坐标 | 174| OH_METAKEY_BLUE_PRIMARY_Y | 蓝基色Y坐标 | 175| OH_METAKEY_WHITE_PRIMARY_X | 白点X坐标 | 176| OH_METAKEY_WHITE_PRIMARY_Y | 白点Y坐标 | 177| OH_METAKEY_MAX_LUMINANCE | 最大的光亮度 | 178| OH_METAKEY_MIN_LUMINANCE | 最小的光亮度 | 179| OH_METAKEY_MAX_CONTENT_LIGHT_LEVEL | 最大的内容亮度水平 | 180| OH_METAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL | 最大的帧平均亮度水平 | 181| OH_METAKEY_HDR10_PLUS | HDR10 Plus | 182| OH_METAKEY_HDR_VIVID | Vivid | 183 184 185### OHScalingMode 186 187 188``` 189enum OHScalingMode 190``` 191 192**描述:** 193 194缩放模式 Scaling Mode 195 196**起始版本:** 197 1989 199 200**弃用:** 201 202从API version 10开始废弃，不再提供替代接口 203 204| 枚举值 | 描述 | 205| -------- | -------- | 206| OH_SCALING_MODE_FREEZE | 在接收到窗口大小的缓冲区之前，不可以更新窗口内容 | 207| OH_SCALING_MODE_SCALE_TO_WINDOW | 缓冲区在二维中缩放以匹配窗口大小 | 208| OH_SCALING_MODE_SCALE_CROP | 缓冲区被统一缩放，使得缓冲区的较小尺寸与窗口大小匹配 | 209| OH_SCALING_MODE_NO_SCALE_CROP | 窗口被裁剪为缓冲区裁剪矩形的大小，裁剪矩形之外的像素被视为完全透明 | 210 211 212## 函数说明 213 214 215### OH_NativeWindow_CreateNativeWindow() 216 217 218``` 219OHNativeWindow* OH_NativeWindow_CreateNativeWindow (void * pSurface) 220``` 221 222**描述:** 223 224创建OHNativeWindow实例，每次调用都会产生一个新的OHNativeWindow实例 225 226\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 227 228**参数:** 229 230| 名称 | 描述 | 231| -------- | -------- | 232| pSurface | 一个指向生产者ProduceSurface的指针，类型为sptr<OHOS::Surface> | 233 234**返回:** 235 236返回一个指针，指向OHNativeWindow的结构体实例 237 238> **说明:** 239> 240> 此接口不支持使用，可通过[OH_NativeImage_AcquireNativeWindow](_o_h___native_image.md#oh_nativeimage_acquirenativewindow)获取，或通过XComponent创建。 241 242 243### OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer() 244 245 246``` 247OHNativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer (void * pSurfaceBuffer) 248``` 249 250**描述:** 251 252创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例 253 254\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 255 256**参数:** 257 258| 名称 | 描述 | 259| -------- | -------- | 260| pSurfaceBuffer | 一个指向生产者buffer的指针，类型为sptr<OHOS::SurfaceBuffer> | 261 262**返回:** 263 264返回一个指针，指向OHNativeWindowBuffer的结构体实例 265 266> **说明:** 267> 268> 此接口不支持使用。 269 270### OH_NativeWindow_DestroyNativeWindow() 271 272 273``` 274void OH_NativeWindow_DestroyNativeWindow (OHNativeWindow * window) 275``` 276 277**描述:** 278 279将OHNativeWindow对象的引用计数减1，当引用计数为0的时候，该OHNativeWindow对象会被析构掉 280 281\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 282 283**参数:** 284 285| 名称 | 描述 | 286| -------- | -------- | 287| window | 一个OHNativeWindow的结构体实例的指针 | 288 289 290### OH_NativeWindow_DestroyNativeWindowBuffer() 291 292 293``` 294void OH_NativeWindow_DestroyNativeWindowBuffer (OHNativeWindowBuffer * buffer) 295``` 296 297**描述:** 298 299将OHNativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该OHNativeWindowBuffer对象会被析构掉 300 301\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 302 303**参数:** 304 305| 名称 | 描述 | 306| -------- | -------- | 307| buffer | 一个OHNativeWindowBuffer的结构体实例的指针 | 308 309 310### OH_NativeWindow_GetBufferHandleFromNative() 311 312 313``` 314BufferHandle* OH_NativeWindow_GetBufferHandleFromNative (OHNativeWindowBuffer * buffer) 315``` 316 317**描述:** 318 319通过OHNativeWindowBuffer获取该buffer的BufferHandle指针 320 321\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 322 323**参数:** 324 325| 名称 | 描述 | 326| -------- | -------- | 327| buffer | 一个OHNativeWindowBuffer的结构体实例的指针 | 328 329**返回:** 330 331BufferHandle 返回一个指针，指向BufferHandle的结构体实例 332 333 334### OH_NativeWindow_GetNativeObjectMagic() 335 336 337``` 338int32_t OH_NativeWindow_GetNativeObjectMagic (void * obj) 339``` 340 341**描述:** 342 343获取NativeObject的MagicId 344 345\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 346 347**参数:** 348 349| 名称 | 描述 | 350| -------- | -------- | 351| obj | 一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针 | 352 353**返回:** 354 355MagicId 返回值为魔鬼数字，每个NativeObject唯一 356 357 358### OH_NativeWindow_NativeObjectReference() 359 360 361``` 362int32_t OH_NativeWindow_NativeObjectReference (void * obj) 363``` 364 365**描述:** 366 367增加一个NativeObject的引用计数 368 369\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 370 371**参数:** 372 373| 名称 | 描述 | 374| -------- | -------- | 375| obj | 一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针 | 376 377**返回:** 378 379返回值为0表示执行成功 380 381 382### OH_NativeWindow_NativeObjectUnreference() 383 384 385``` 386int32_t OH_NativeWindow_NativeObjectUnreference (void * obj) 387``` 388 389**描述:** 390 391减少一个NativeObject的引用计数，当引用计数减少为0时，该NativeObject将被析构掉 392 393\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 394 395**参数:** 396 397| 名称 | 描述 | 398| -------- | -------- | 399| obj | 一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针 | 400 401**返回:** 402 403返回值为0表示执行成功 404 405 406### OH_NativeWindow_NativeWindowAbortBuffer() 407 408 409``` 410int32_t OH_NativeWindow_NativeWindowAbortBuffer (OHNativeWindow * window, OHNativeWindowBuffer * buffer ) 411``` 412 413**描述:** 414 415通过OHNativeWindow将之前申请出来的OHNativeWindowBuffer返还到Buffer队列中，供下次再申请 416 417\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 418 419**参数:** 420 421| 名称 | 描述 | 422| -------- | -------- | 423| window | 一个OHNativeWindow的结构体实例的指针 | 424| buffer | 一个OHNativeWindowBuffer的结构体实例的指针 | 425 426**返回:** 427 428返回值为0表示执行成功 429 430 431### OH_NativeWindow_NativeWindowFlushBuffer() 432 433 434``` 435int32_t OH_NativeWindow_NativeWindowFlushBuffer (OHNativeWindow * window, OHNativeWindowBuffer * buffer, int fenceFd, Region region ) 436``` 437 438**描述:** 439 440通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费 441 442\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 443 444**参数:** 445 446| 名称 | 描述 | 447| -------- | -------- | 448| window | 一个OHNativeWindow的结构体实例的指针 | 449| buffer | 一个OHNativeWindowBuffer的结构体实例的指针 | 450| fenceFd | 一个文件描述符句柄，用以同步时序 | 451| region | 表示一块脏区域，该区域有内容更新 | 452 453**返回:** 454 455返回值为0表示执行成功 456 457 458### OH_NativeWindow_NativeWindowHandleOpt() 459 460 461``` 462int32_t OH_NativeWindow_NativeWindowHandleOpt (OHNativeWindow * window, int code, ... ) 463``` 464 465**描述:** 466 467设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等 468 469\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 470 471**参数:** 472 473| 名称 | 描述 | 474| -------- | -------- | 475| window | 一个OHNativeWindow的结构体实例的指针 | 476| code | 表示操作码，详见[NativeWindowOperation](#nativewindowoperation) | 477| ... | 可变参数，必须与操作码一一对应 | 478 479**返回:** 480 481返回值为0表示执行成功 482 483 484### OH_NativeWindow_NativeWindowRequestBuffer() 485 486 487``` 488int32_t OH_NativeWindow_NativeWindowRequestBuffer (OHNativeWindow * window, OHNativeWindowBuffer ** buffer, int * fenceFd ) 489``` 490 491**描述:** 492 493通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产 494 495\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 496 497**参数:** 498 499| 名称 | 描述 | 500| -------- | -------- | 501| window | 一个OHNativeWindow的结构体实例的指针 | 502| buffer | 一个OHNativeWindowBuffer的结构体实例的二级指针 | 503| fenceFd | 一个文件描述符句柄 | 504 505**返回:** 506 507返回值为0表示执行成功 508 509 510### OH_NativeWindow_NativeWindowSetMetaData() 511 512 513``` 514int32_t OH_NativeWindow_NativeWindowSetMetaData (OHNativeWindow * window, uint32_t sequence, int32_t size, const OHHDRMetaData * metaData ) 515``` 516 517**描述:** 518 519设置OHNativeWindow的元数据 520 521\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 522 523**参数:** 524 525| 名称 | 描述 | 526| -------- | -------- | 527| window | 一个OHNativeWindow的结构体实例的指针 | 528| sequence | 生产缓冲区的序列 | 529| size | OHHDRMetaData数组的大小 | 530| metaDate | 指向OHHDRMetaData数组的指针 | 531 532**返回:** 533 534返回值为0表示执行成功 535 536**起始版本:** 537 5389 539 540**弃用:** 541 542从API version 10开始废弃，不再提供替代接口 543 544 545### OH_NativeWindow_NativeWindowSetMetaDataSet() 546 547 548``` 549int32_t OH_NativeWindow_NativeWindowSetMetaDataSet (OHNativeWindow * window, uint32_t sequence, OHHDRMetadataKey key, int32_t size, const uint8_t * metaData ) 550``` 551 552**描述:** 553 554设置OHNativeWindow的元数据集。 555 556\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 557 558**参数:** 559 560| 名称 | 描述 | 561| -------- | -------- | 562| window | 一个OHNativeWindow的结构体实例的指针。 | 563| sequence | 生产缓冲区的序列。 | 564| key | 枚举值OHHDRMetadataKey | 565| size | uint8_t向量的大小 | 566| metaDate | 指向uint8_t向量的指针 | 567 568**返回:** 569 570返回值为0表示执行成功 571 572**起始版本:** 573 5749 575 576**弃用:** 577 578从API version 10开始废弃，不再提供替代接口 579 580 581### OH_NativeWindow_NativeWindowSetScalingMode() 582 583 584``` 585int32_t OH_NativeWindow_NativeWindowSetScalingMode (OHNativeWindow * window, uint32_t sequence, OHScalingMode scalingMode ) 586``` 587 588**描述:** 589 590设置OHNativeWindow的ScalingMode 591 592\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 593 594**参数:** 595 596| 名称 | 描述 | 597| -------- | -------- | 598| window | 一个OHNativeWindow的结构体实例的指针 | 599| sequence | 生产缓冲区的序列 | 600| scalingMode | 枚举值OHScalingMode | 601 602**返回:** 603 604返回值为0表示执行成功 605 606**起始版本:** 607 6089 609 610**弃用:** 611 612从API version 10开始废弃，不再提供替代接口 613 614 615### OH_NativeWindow_NativeWindowSetTunnelHandle() 616 617 618``` 619int32_t OH_NativeWindow_NativeWindowSetTunnelHandle (OHNativeWindow * window, const OHExtDataHandle * handle ) 620``` 621 622**描述:** 623 624设置OHNativeWindow的TunnelHandle。 625 626\@syscap SystemCapability.Graphic.Graphic2D.NativeWindow 627 628**参数:** 629 630| 名称 | 描述 | 631| -------- | -------- | 632| window | 一个OHNativeWindow的结构体实例的指针 | 633| handle | 指向OHExtDataHandle的指针 | 634 635**返回:** 636 637返回值为0表示执行成功 638 639**起始版本:** 640 6419 642 643**弃用:** 644 645从API version 10开始废弃，不再提供替代接口 646