1# oh_display_manager.h 2<!--Kit: ArkUI--> 3<!--Subsystem: Window--> 4<!--Owner: @oh_wangxk; @logn--> 5<!--Designer: @hejunfei1991--> 6<!--Tester: @qinliwen0417--> 7<!--Adviser: @ge-yafang--> 8 9## 概述 10 11提供屏幕管理的一些基础能力，包括获取默认显示设备的信息，以及监听显示设备的旋转、折叠、展开等状态变化的能力。 12 13**引用文件：** <window_manager/oh_display_manager.h> 14 15**库：** libnative_display_manager.so. 16 17**系统能力：** SystemCapability.WindowManager.WindowManager.Core 18 19**起始版本：** 12 20 21**相关模块：** [OH_DisplayManager](capi-oh-displaymanager.md) 22 23## 汇总 24 25### 函数 26 27| 名称 | typedef关键字 | 描述 | 28| -- | -- | -- | 29| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayId(uint64_t *displayId)](#oh_nativedisplaymanager_getdefaultdisplayid) | - | 获取默认屏幕的id号。 | 30| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayWidth(int32_t *displayWidth)](#oh_nativedisplaymanager_getdefaultdisplaywidth) | - | 获取默认屏幕的宽度。 | 31| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayHeight(int32_t *displayHeight)](#oh_nativedisplaymanager_getdefaultdisplayheight) | - | 获取默认屏幕的高度。 | 32| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayRotation(NativeDisplayManager_Rotation *displayRotation)](#oh_nativedisplaymanager_getdefaultdisplayrotation) | - | 获取默认屏幕的顺时针旋转角度。 | 33| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayOrientation(NativeDisplayManager_Orientation *displayOrientation)](#oh_nativedisplaymanager_getdefaultdisplayorientation) | - | 获取默认屏幕的旋转方向。 | 34| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayVirtualPixelRatio(float *virtualPixels)](#oh_nativedisplaymanager_getdefaultdisplayvirtualpixelratio) | - | 获取默认屏幕的虚拟像素密度。 | 35| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayRefreshRate(uint32_t *refreshRate)](#oh_nativedisplaymanager_getdefaultdisplayrefreshrate) | - | 获取默认屏幕的刷新率。 | 36| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityDpi(int32_t *densityDpi)](#oh_nativedisplaymanager_getdefaultdisplaydensitydpi) | - | 获取屏幕的物理像素密度。 | 37| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityPixels(float *densityPixels)](#oh_nativedisplaymanager_getdefaultdisplaydensitypixels) | - | 获取屏幕逻辑像素的密度。 | 38| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayScaledDensity(float *scaledDensity)](#oh_nativedisplaymanager_getdefaultdisplayscaleddensity) | - | 获取屏幕显示字体的缩放因子。 | 39| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityXdpi(float *xDpi)](#oh_nativedisplaymanager_getdefaultdisplaydensityxdpi) | - | 获取屏幕X方向中每英寸屏幕的物理像素值。 | 40| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityYdpi(float *yDpi)](#oh_nativedisplaymanager_getdefaultdisplaydensityydpi) | - | 获取Y方向中每英寸屏幕的物理像素值。 | 41| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo(NativeDisplayManager_CutoutInfo **cutoutInfo)](#oh_nativedisplaymanager_createdefaultdisplaycutoutinfo) | - | 获取挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。 | 42| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_DestroyDefaultDisplayCutoutInfo(NativeDisplayManager_CutoutInfo *cutoutInfo)](#oh_nativedisplaymanager_destroydefaultdisplaycutoutinfo) | - | 销毁挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。 | 43| [bool OH_NativeDisplayManager_IsFoldable()](#oh_nativedisplaymanager_isfoldable) | - | 查询设备是否可折叠。 | 44| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetFoldDisplayMode(NativeDisplayManager_FoldDisplayMode *displayMode)](#oh_nativedisplaymanager_getfolddisplaymode) | - | 获取可折叠设备的显示模式。 | 45| [typedef void (\*OH_NativeDisplayManager_DisplayChangeCallback)(uint64_t displayId)](#oh_nativedisplaymanager_displaychangecallback) | OH_NativeDisplayManager_DisplayChangeCallback | 注册屏幕状态变化的回调函数。 | 46| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayChangeListener(OH_NativeDisplayManager_DisplayChangeCallback displayChangeCallback, uint32_t *listenerIndex)](#oh_nativedisplaymanager_registerdisplaychangelistener) | - | 注册屏幕状态变化监听（如旋转变化、刷新率、DPI、分辨率等变化）。 | 47| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayChangeListener(uint32_t listenerIndex)](#oh_nativedisplaymanager_unregisterdisplaychangelistener) | - | 取消屏幕状态变化的监听。 | 48| [typedef void (\*OH_NativeDisplayManager_FoldDisplayModeChangeCallback)(NativeDisplayManager_FoldDisplayMode displayMode)](#oh_nativedisplaymanager_folddisplaymodechangecallback) | OH_NativeDisplayManager_FoldDisplayModeChangeCallback | 注册屏幕展开、折叠状态变化的回调函数。 | 49| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener(OH_NativeDisplayManager_FoldDisplayModeChangeCallback displayModeChangeCallback, uint32_t *listenerIndex)](#oh_nativedisplaymanager_registerfolddisplaymodechangelistener) | - | 注册屏幕展开、折叠状态变化的监听。 | 50| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener(uint32_t listenerIndex)](#oh_nativedisplaymanager_unregisterfolddisplaymodechangelistener) | - | 取消屏幕展开、折叠状态变化的监听。 | 51| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateAllDisplays(NativeDisplayManager_DisplaysInfo **allDisplays)](#oh_nativedisplaymanager_createalldisplays) | - | 获取当前所有屏幕信息对象。 | 52| [void OH_NativeDisplayManager_DestroyAllDisplays(NativeDisplayManager_DisplaysInfo *allDisplays)](#oh_nativedisplaymanager_destroyalldisplays) | - | 销毁所有屏幕的信息对象。 | 53| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateDisplayById(uint32_t displayId,NativeDisplayManager_DisplayInfo **displayInfo)](#oh_nativedisplaymanager_createdisplaybyid) | - | 获取指定屏幕的信息对象。 | 54| [void OH_NativeDisplayManager_DestroyDisplay(NativeDisplayManager_DisplayInfo *displayInfo)](#oh_nativedisplaymanager_destroydisplay) | - | 销毁指定屏幕的信息对象。 | 55| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreatePrimaryDisplay(NativeDisplayManager_DisplayInfo **displayInfo)](#oh_nativedisplaymanager_createprimarydisplay) | - | 获取主屏信息对象。除2in1之外的设备获取的是设备自带屏幕的屏幕信息；2in1设备外接屏幕时获取的是当前主屏幕的屏幕信息；2in1设备没有外接屏幕时获取的是自带屏幕的屏幕信息。 | 56| [typedef void (\*OH_NativeDisplayManager_AvailableAreaChangeCallback)(uint64_t displayId)](#oh_nativedisplaymanager_availableareachangecallback) | OH_NativeDisplayManager_AvailableAreaChangeCallback | 注册屏幕可用区域变化的回调函数。 | 57| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterAvailableAreaChangeListener(OH_NativeDisplayManager_AvailableAreaChangeCallback availableAreaChangeCallback, uint32_t *listenerIndex)](#oh_nativedisplaymanager_registeravailableareachangelistener) | - | 注册屏幕可用区域变化监听。 | 58| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterAvailableAreaChangeListener(uint32_t listenerIndex)](#oh_nativedisplaymanager_unregisteravailableareachangelistener) | - | 取消屏幕可用区域变化的监听。 | 59| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateAvailableArea(uint64_t displayId, NativeDisplayManager_Rect **availableArea)](#oh_nativedisplaymanager_createavailablearea) | - | 获取屏幕的可用区域。 | 60| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_DestroyAvailableArea(NativeDisplayManager_Rect *availableArea)](#oh_nativedisplaymanager_destroyavailablearea) | - | 销毁屏幕的可用区域。 | 61| [typedef void (\*OH_NativeDisplayManager_DisplayAddCallback)(uint64_t displayId)](#oh_nativedisplaymanager_displayaddcallback) | OH_NativeDisplayManager_DisplayAddCallback | 注册屏幕连接的回调函数。 | 62| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayAddListener(OH_NativeDisplayManager_DisplayAddCallback displayAddCallback, uint32_t *listenerIndex)](#oh_nativedisplaymanager_registerdisplayaddlistener) | - | 注册屏幕连接变化监听（如插入显示器）。 | 63| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayAddListener(uint32_t listenerIndex)](#oh_nativedisplaymanager_unregisterdisplayaddlistener) | - | 取消屏幕连接的监听。 | 64| [typedef void (\*OH_NativeDisplayManager_DisplayRemoveCallback)(uint64_t displayId)](#oh_nativedisplaymanager_displayremovecallback) | OH_NativeDisplayManager_DisplayRemoveCallback | 注册屏幕移除的回调函数。 | 65| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayRemoveListener(OH_NativeDisplayManager_DisplayRemoveCallback displayRemoveCallback, uint32_t *listenerIndex)](#oh_nativedisplaymanager_registerdisplayremovelistener) | - | 注册屏幕移除变化监听（如移除显示器）。 | 66| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayRemoveListener(uint32_t listenerIndex)](#oh_nativedisplaymanager_unregisterdisplayremovelistener) | - | 取消屏幕移除的监听。 | 67| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDisplaySourceMode(uint64_t displayId, NativeDisplayManager_SourceMode *sourceMode)](#oh_nativedisplaymanager_getdisplaysourcemode) | - | 获取屏幕的显示模式。 | 68| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDisplayPosition(uint64_t displayId, int32_t *x, int32_t *y)](#oh_nativedisplaymanager_getdisplayposition) | - | 获取屏幕的位置信息。 | 69 70## 函数说明 71 72### OH_NativeDisplayManager_GetDefaultDisplayId() 73 74``` 75NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayId(uint64_t *displayId) 76``` 77 78**描述** 79 80获取默认屏幕的id号。 81 82**起始版本：** 12 83 84 85**参数：** 86 87| 参数项 | 描述 | 88| -- | -- | 89| uint64_t *displayId | 默认屏幕的id号，非负整数，此处作为出参返回。 | 90 91**返回：** 92 93| 类型 | 说明 | 94| -- | -- | 95| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 96 97### OH_NativeDisplayManager_GetDefaultDisplayWidth() 98 99``` 100NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayWidth(int32_t *displayWidth) 101``` 102 103**描述** 104 105获取默认屏幕的宽度。 106 107**起始版本：** 12 108 109 110**参数：** 111 112| 参数项 | 描述 | 113| -- | -- | 114| int32_t *displayWidth | 默认屏幕的宽度，单位为px，该参数应为整数，此处作为出参返回。 | 115 116**返回：** 117 118| 类型 | 说明 | 119| -- | -- | 120| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 121 122### OH_NativeDisplayManager_GetDefaultDisplayHeight() 123 124``` 125NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayHeight(int32_t *displayHeight) 126``` 127 128**描述** 129 130获取默认屏幕的高度。 131 132**起始版本：** 12 133 134 135**参数：** 136 137| 参数项 | 描述 | 138| -- | -- | 139| int32_t *displayHeight | 默认屏幕的高度，单位为px，该参数应为整数，此处作为出参返回。 | 140 141**返回：** 142 143| 类型 | 说明 | 144| -- | -- | 145| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 146 147### OH_NativeDisplayManager_GetDefaultDisplayRotation() 148 149``` 150NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayRotation(NativeDisplayManager_Rotation *displayRotation) 151``` 152 153**描述** 154 155获取默认屏幕的顺时针旋转角度。 156 157**起始版本：** 12 158 159 160**参数：** 161 162| 参数项 | 描述 | 163| -- | -- | 164| [NativeDisplayManager_Rotation](capi-oh-display-info-h.md#nativedisplaymanager_rotation) *displayRotation | 默认屏幕的顺时针旋转角度，具体可见[NativeDisplayManager_Rotation](capi-oh-display-info-h.md#nativedisplaymanager_rotation)，此处作为出参返回。 | 165 166**返回：** 167 168| 类型 | 说明 | 169| -- | -- | 170| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 171 172### OH_NativeDisplayManager_GetDefaultDisplayOrientation() 173 174``` 175NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayOrientation(NativeDisplayManager_Orientation *displayOrientation) 176``` 177 178**描述** 179 180获取默认屏幕的旋转方向。 181 182**起始版本：** 12 183 184 185**参数：** 186 187| 参数项 | 描述 | 188| -- | -- | 189| [NativeDisplayManager_Orientation](capi-oh-display-info-h.md#nativedisplaymanager_orientation) *displayOrientation | 屏幕当前显示的方向，具体可见[NativeDisplayManager_Orientation](capi-oh-display-info-h.md#nativedisplaymanager_orientation)，此处作为出参返回。 | 190 191**返回：** 192 193| 类型 | 说明 | 194| -- | -- | 195| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 196 197### OH_NativeDisplayManager_GetDefaultDisplayVirtualPixelRatio() 198 199``` 200NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayVirtualPixelRatio(float *virtualPixels) 201``` 202 203**描述** 204 205获取默认屏幕的虚拟像素密度。 206 207**起始版本：** 12 208 209 210**参数：** 211 212| 参数项 | 描述 | 213| -- | -- | 214| float *virtualPixels | 屏幕的虚拟像素密度，该参数为浮点数，通常与densityPixels相同，此处作为出参返回。 | 215 216**返回：** 217 218| 类型 | 说明 | 219| -- | -- | 220| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 221 222### OH_NativeDisplayManager_GetDefaultDisplayRefreshRate() 223 224``` 225NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayRefreshRate(uint32_t *refreshRate) 226``` 227 228**描述** 229 230获取默认屏幕的刷新率。 231 232**起始版本：** 12 233 234 235**参数：** 236 237| 参数项 | 描述 | 238| -- | -- | 239| uint32_t *refreshRate | 屏幕的刷新率，该参数应为整数，单位为Hz，此处作为出参返回。 | 240 241**返回：** 242 243| 类型 | 说明 | 244| -- | -- | 245| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 246 247### OH_NativeDisplayManager_GetDefaultDisplayDensityDpi() 248 249``` 250NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityDpi(int32_t *densityDpi) 251``` 252 253**描述** 254 255获取屏幕的物理像素密度。 256 257**起始版本：** 12 258 259 260**参数：** 261 262| 参数项 | 描述 | 263| -- | -- | 264| int32_t *densityDpi | 屏幕的物理像素密度，表示每英寸上的像素点数。该参数为整数，单位为px，实际能取到的值取决于不同设备设置里提供的可选值。此处作为出参返回。 | 265 266**返回：** 267 268| 类型 | 说明 | 269| -- | -- | 270| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 271 272### OH_NativeDisplayManager_GetDefaultDisplayDensityPixels() 273 274``` 275NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityPixels(float *densityPixels) 276``` 277 278**描述** 279 280获取屏幕逻辑像素的密度。 281 282**起始版本：** 12 283 284 285**参数：** 286 287| 参数项 | 描述 | 288| -- | -- | 289| float *densityPixels | 设备逻辑像素的密度，代表物理像素与逻辑像素的缩放系数，该参数为浮点数，受densityDPI范围限制，取值范围在[0.5，4.0]。一般取值1.0、3.0等，实际取值取决于不同设备提供的densityDpi。此处作为出参返回。 | 290 291**返回：** 292 293| 类型 | 说明 | 294| -- | -- | 295| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 296 297### OH_NativeDisplayManager_GetDefaultDisplayScaledDensity() 298 299``` 300NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayScaledDensity(float *scaledDensity) 301``` 302 303**描述** 304 305获取屏幕显示字体的缩放因子。 306 307**起始版本：** 12 308 309 310**参数：** 311 312| 参数项 | 描述 | 313| -- | -- | 314| float *scaledDensity | 显示字体的缩放因子，该参数为浮点数，通常与densityPixels相同，此处作为出参返回。 | 315 316**返回：** 317 318| 类型 | 说明 | 319| -- | -- | 320| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 321 322### OH_NativeDisplayManager_GetDefaultDisplayDensityXdpi() 323 324``` 325NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityXdpi(float *xDpi) 326``` 327 328**描述** 329 330获取屏幕X方向中每英寸屏幕的物理像素值。 331 332**起始版本：** 12 333 334 335**参数：** 336 337| 参数项 | 描述 | 338| -- | -- | 339| float *xDpi | X方向中每英寸屏幕的物理像素值，该参数为浮点数，此处作为出参返回。 | 340 341**返回：** 342 343| 类型 | 说明 | 344| -- | -- | 345| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 346 347### OH_NativeDisplayManager_GetDefaultDisplayDensityYdpi() 348 349``` 350NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityYdpi(float *yDpi) 351``` 352 353**描述** 354 355获取Y方向中每英寸屏幕的物理像素值。 356 357**起始版本：** 12 358 359 360**参数：** 361 362| 参数项 | 描述 | 363| -- | -- | 364| float *yDpi | 获取Y方向中每英寸屏幕的物理像素值，该参数为浮点数，此处作为出参返回。 | 365 366**返回：** 367 368| 类型 | 说明 | 369| -- | -- | 370| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 371 372### OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo() 373 374``` 375NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo(NativeDisplayManager_CutoutInfo **cutoutInfo) 376``` 377 378**描述** 379 380获取挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。 381 382**起始版本：** 12 383 384 385**参数：** 386 387| 参数项 | 描述 | 388| -- | -- | 389| [NativeDisplayManager_CutoutInfo](capi-nativedisplaymanager-cutoutinfo.md) **cutoutInfo | 挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息，具体可见[NativeDisplayManager_CutoutInfo](capi-nativedisplaymanager-cutoutinfo.md)，此处作为出参返回。 | 390 391**返回：** 392 393| 类型 | 说明 | 394| -- | -- | 395| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 396 397### OH_NativeDisplayManager_DestroyDefaultDisplayCutoutInfo() 398 399``` 400NativeDisplayManager_ErrorCode OH_NativeDisplayManager_DestroyDefaultDisplayCutoutInfo(NativeDisplayManager_CutoutInfo *cutoutInfo) 401``` 402 403**描述** 404 405销毁挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。 406 407**起始版本：** 12 408 409 410**参数：** 411 412| 参数项 | 描述 | 413| -- | -- | 414| [NativeDisplayManager_CutoutInfo](capi-nativedisplaymanager-cutoutinfo.md) *cutoutInfo | 销毁通过[OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo](capi-oh-display-manager-h.md#oh_nativedisplaymanager_createdefaultdisplaycutoutinfo)接口获取的挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息对象，具体可见[NativeDisplayManager_CutoutInfo](capi-nativedisplaymanager-cutoutinfo.md)。 | 415 416**返回：** 417 418| 类型 | 说明 | 419| -- | -- | 420| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 421 422### OH_NativeDisplayManager_IsFoldable() 423 424``` 425bool OH_NativeDisplayManager_IsFoldable() 426``` 427 428**描述** 429 430查询设备是否可折叠。 431 432**起始版本：** 12 433 434**返回：** 435 436| 类型 | 说明 | 437| -- | -- | 438| bool | 返回查询设备是否可折叠的结果。true表示设备可折叠，false表示设备不可折叠。 | 439 440### OH_NativeDisplayManager_GetFoldDisplayMode() 441 442``` 443NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetFoldDisplayMode(NativeDisplayManager_FoldDisplayMode *displayMode) 444``` 445 446**描述** 447 448获取可折叠设备的显示模式。 449 450**起始版本：** 12 451 452**设备行为差异：** 该接口在2in1设备、非折叠设备中返回0，在其他设备中可正常调用。 453 454 455**参数：** 456 457| 参数项 | 描述 | 458| -- | -- | 459| [NativeDisplayManager_FoldDisplayMode](capi-oh-display-info-h.md#nativedisplaymanager_folddisplaymode) *displayMode | 折叠设备当前的显示模式，具体可见[NativeDisplayManager_FoldDisplayMode](capi-oh-display-info-h.md#nativedisplaymanager_folddisplaymode)，此处作为出参返回。 | 460 461**返回：** 462 463| 类型 | 说明 | 464| -- | -- | 465| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 466 467### OH_NativeDisplayManager_DisplayChangeCallback() 468 469``` 470typedef void (*OH_NativeDisplayManager_DisplayChangeCallback)(uint64_t displayId) 471``` 472 473**描述** 474 475注册屏幕状态变化的回调函数。 476 477**起始版本：** 12 478 479 480**参数：** 481 482| 参数项 | 描述 | 483| -- | -- | 484| uint64_t displayId | 屏幕状态发生变化的编号。 | 485 486### OH_NativeDisplayManager_RegisterDisplayChangeListener() 487 488``` 489NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayChangeListener(OH_NativeDisplayManager_DisplayChangeCallback displayChangeCallback, uint32_t *listenerIndex) 490``` 491 492**描述** 493 494注册屏幕状态变化监听（如旋转变化、刷新率、DPI、分辨率等变化）。 495 496**起始版本：** 12 497 498 499**参数：** 500 501| 参数项 | 描述 | 502| -- | -- | 503| [OH_NativeDisplayManager_DisplayChangeCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_displaychangecallback) displayChangeCallback | 屏幕状态变化后触发的回调函数，回调函数定义见[OH_NativeDisplayManager_DisplayChangeCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_displaychangecallback)。 | 504| uint32_t *listenerIndex | 注册成功后返回的监听编号，调用取消注册函数[OH_NativeDisplayManager_UnregisterDisplayChangeListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_unregisterdisplaychangelistener)时作为入参使用，此处作为出参返回。 | 505 506**返回：** 507 508| 类型 | 说明 | 509| -- | -- | 510| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 511 512### OH_NativeDisplayManager_UnregisterDisplayChangeListener() 513 514``` 515NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayChangeListener(uint32_t listenerIndex) 516``` 517 518**描述** 519 520取消屏幕状态变化的监听。 521 522**起始版本：** 12 523 524 525**参数：** 526 527| 参数项 | 描述 | 528| -- | -- | 529| uint32_t listenerIndex | 调用注册函数[OH_NativeDisplayManager_RegisterDisplayChangeListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_registerdisplaychangelistener)时获取到的监听编号。 | 530 531**返回：** 532 533| 类型 | 说明 | 534| -- | -- | 535| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 536 537### OH_NativeDisplayManager_FoldDisplayModeChangeCallback() 538 539``` 540typedef void (*OH_NativeDisplayManager_FoldDisplayModeChangeCallback)(NativeDisplayManager_FoldDisplayMode displayMode) 541``` 542 543**描述** 544 545注册屏幕展开、折叠状态变化的回调函数。 546 547**起始版本：** 12 548 549 550**参数：** 551 552| 参数项 | 描述 | 553| -- | -- | 554| [NativeDisplayManager_FoldDisplayMode](capi-oh-display-info-h.md#nativedisplaymanager_folddisplaymode) displayMode | 折叠/展开动作执行后屏幕的状态，具体可见[NativeDisplayManager_FoldDisplayMode](capi-oh-display-info-h.md#nativedisplaymanager_folddisplaymode)。 | 555 556### OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener() 557 558``` 559NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener(OH_NativeDisplayManager_FoldDisplayModeChangeCallback displayModeChangeCallback, uint32_t *listenerIndex) 560``` 561 562**描述** 563 564注册屏幕展开、折叠状态变化的监听。 565 566**起始版本：** 12 567 568 569**参数：** 570 571| 参数项 | 描述 | 572| -- | -- | 573| [OH_NativeDisplayManager_FoldDisplayModeChangeCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_folddisplaymodechangecallback) displayModeChangeCallback | 屏幕展开和折叠变化后触发的回调函数，回调函数定义见[OH_NativeDisplayManager_FoldDisplayModeChangeCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_folddisplaymodechangecallback)。 | 574| uint32_t *listenerIndex | 注册成功后返回的监听编号，调用取消注册函数[OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_unregisterfolddisplaymodechangelistener)时作为入参使用，此处作为出参返回。 | 575 576**返回：** 577 578| 类型 | 说明 | 579| -- | -- | 580| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 581 582### OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener() 583 584``` 585NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener(uint32_t listenerIndex) 586``` 587 588**描述** 589 590取消屏幕展开、折叠状态变化的监听。 591 592**起始版本：** 12 593 594 595**参数：** 596 597| 参数项 | 描述 | 598| -- | -- | 599| uint32_t listenerIndex | 调用注册函数[OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_registerfolddisplaymodechangelistener)时获取到的监听编号。 | 600 601**返回：** 602 603| 类型 | 说明 | 604| -- | -- | 605| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 606 607### OH_NativeDisplayManager_CreateAllDisplays() 608 609``` 610NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateAllDisplays(NativeDisplayManager_DisplaysInfo **allDisplays) 611``` 612 613**描述** 614 615获取当前所有屏幕信息对象。 616 617**起始版本：** 14 618 619 620**参数：** 621 622| 参数项 | 描述 | 623| -- | -- | 624| [NativeDisplayManager_DisplaysInfo](capi-nativedisplaymanager-displaysinfo.md) **allDisplays | 当前所有的屏幕信息，具体可见[NativeDisplayManager_DisplaysInfo](capi-nativedisplaymanager-displaysinfo.md)，此处作为出参返回。 | 625 626**返回：** 627 628| 类型 | 说明 | 629| -- | -- | 630| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 631 632### OH_NativeDisplayManager_DestroyAllDisplays() 633 634``` 635void OH_NativeDisplayManager_DestroyAllDisplays(NativeDisplayManager_DisplaysInfo *allDisplays) 636``` 637 638**描述** 639 640销毁所有屏幕的信息对象。 641 642**起始版本：** 14 643 644 645**参数：** 646 647| 参数项 | 描述 | 648| -- | -- | 649| [NativeDisplayManager_DisplaysInfo](capi-nativedisplaymanager-displaysinfo.md) *allDisplays | 销毁通过[OH_NativeDisplayManager_CreateAllDisplays](capi-oh-display-manager-h.md#oh_nativedisplaymanager_createalldisplays)接口获取的所有的屏幕信息，具体可见[NativeDisplayManager_DisplaysInfo](capi-nativedisplaymanager-displaysinfo.md)。 | 650 651### OH_NativeDisplayManager_CreateDisplayById() 652 653``` 654NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateDisplayById(uint32_t displayId,NativeDisplayManager_DisplayInfo **displayInfo) 655``` 656 657**描述** 658 659获取指定屏幕的信息对象。 660 661**起始版本：** 14 662 663 664**参数：** 665 666| 参数项 | 描述 | 667| -- | -- | 668| uint32_t displayId | 指定屏幕的id编号，该值为非负整数。 | 669| [NativeDisplayManager_DisplayInfo](capi-nativedisplaymanager-displayinfo.md) **displayInfo | 指定的屏幕信息对象，具体可见[NativeDisplayManager_DisplayInfo](capi-nativedisplaymanager-displayinfo.md)，此处作为出参返回。 | 670 671**返回：** 672 673| 类型 | 说明 | 674| -- | -- | 675| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 676 677### OH_NativeDisplayManager_DestroyDisplay() 678 679``` 680void OH_NativeDisplayManager_DestroyDisplay(NativeDisplayManager_DisplayInfo *displayInfo) 681``` 682 683**描述** 684 685销毁指定屏幕的信息对象。 686 687**起始版本：** 14 688 689 690**参数：** 691 692| 参数项 | 描述 | 693| -- | -- | 694| [NativeDisplayManager_DisplayInfo](capi-nativedisplaymanager-displayinfo.md) *displayInfo | 销毁通过[OH_NativeDisplayManager_CreateDisplayById](capi-oh-display-manager-h.md#oh_nativedisplaymanager_createdisplaybyid)或者[OH_NativeDisplayManager_CreatePrimaryDisplay](capi-oh-display-manager-h.md#oh_nativedisplaymanager_createprimarydisplay)接口获取到的屏幕信息，具体可见[NativeDisplayManager_DisplayInfo](capi-nativedisplaymanager-displayinfo.md)。 | 695 696### OH_NativeDisplayManager_CreatePrimaryDisplay() 697 698``` 699NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreatePrimaryDisplay(NativeDisplayManager_DisplayInfo **displayInfo) 700``` 701 702**描述** 703 704获取主屏信息对象。除2in1之外的设备获取的是设备自带屏幕的屏幕信息；2in1设备外接屏幕时获取的是当前主屏幕的屏幕信息；2in1设备没有外接屏幕时获取的是自带屏幕的屏幕信息。 705 706**起始版本：** 14 707 708 709**参数：** 710 711| 参数项 | 描述 | 712| -- | -- | 713| [NativeDisplayManager_DisplayInfo](capi-nativedisplaymanager-displayinfo.md) **displayInfo | 主屏的屏幕信息对象，具体可见[NativeDisplayManager_DisplayInfo](capi-nativedisplaymanager-displayinfo.md)，此处作为出参返回。 | 714 715**返回：** 716 717| 类型 | 说明 | 718| -- | -- | 719| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 720 721### OH_NativeDisplayManager_AvailableAreaChangeCallback() 722 723``` 724typedef void (*OH_NativeDisplayManager_AvailableAreaChangeCallback)(uint64_t displayId) 725``` 726 727**描述** 728 729注册屏幕可用区域变化的回调函数。 730 731**起始版本：** 20 732 733 734**参数：** 735 736| 参数项 | 描述 | 737| -- | -- | 738| uint64_t displayId | 屏幕的id号，非负整数。 | 739 740### OH_NativeDisplayManager_RegisterAvailableAreaChangeListener() 741 742``` 743NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterAvailableAreaChangeListener(OH_NativeDisplayManager_AvailableAreaChangeCallback availableAreaChangeCallback, uint32_t *listenerIndex) 744``` 745 746**描述** 747 748注册屏幕可用区域变化监听。 749 750**起始版本：** 20 751 752 753**参数：** 754 755| 参数项 | 描述 | 756| -- | -- | 757| [OH_NativeDisplayManager_AvailableAreaChangeCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_availableareachangecallback) availableAreaChangeCallback | 屏幕可用区域变化后触发的回调函数，<br>回调函数定义见[OH_NativeDisplayManager_AvailableAreaChangeCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_availableareachangecallback)。 | 758| uint32_t *listenerIndex | 注册成功后返回的监听编号，<br>调用取消注册函数[OH_NativeDisplayManager_UnregisterAvailableAreaChangeListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_unregisteravailableareachangelistener)时作为入参使用，此处作为出参返回。 | 759 760**返回：** 761 762| 类型 | 说明 | 763| -- | -- | 764| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 765 766### OH_NativeDisplayManager_UnregisterAvailableAreaChangeListener() 767 768``` 769NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterAvailableAreaChangeListener(uint32_t listenerIndex) 770``` 771 772**描述** 773 774取消屏幕可用区域变化的监听。 775 776**起始版本：** 20 777 778 779**参数：** 780 781| 参数项 | 描述 | 782| -- | -- | 783| uint32_t listenerIndex | 调用注册函数<br>[OH_NativeDisplayManager_RegisterAvailableAreaChangeListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_registeravailableareachangelistener)时获取到的监听编号。 | 784 785**返回：** 786 787| 类型 | 说明 | 788| -- | -- | 789| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 790 791### OH_NativeDisplayManager_CreateAvailableArea() 792 793``` 794NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateAvailableArea(uint64_t displayId, NativeDisplayManager_Rect **availableArea) 795``` 796 797**描述** 798 799获取屏幕的可用区域。 800 801**起始版本：** 20 802 803**设备行为差异：** 该接口在2in1设备、Tablet设备中可正常调用；在其他设备中不可用，请通过[OH_NativeDisplayManager_GetDefaultDisplayWidth()](#oh_nativedisplaymanager_getdefaultdisplaywidth)、[OH_NativeDisplayManager_GetDefaultDisplayHeight()](#oh_nativedisplaymanager_getdefaultdisplayheight)获取当前设备屏幕的可用区域。 804 805 806**参数：** 807 808| 参数项 | 描述 | 809| -- | -- | 810| uint64_t displayId | 查询屏幕的id号，非负整数。 | 811| [NativeDisplayManager_Rect](capi-nativedisplaymanager-rect.md) **availableArea | 屏幕可用区域，具体可见[NativeDisplayManager_Rect](capi-nativedisplaymanager-rect.md)，此处作为出参返回。 | 812 813**返回：** 814 815| 类型 | 说明 | 816| -- | -- | 817| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 818 819### OH_NativeDisplayManager_DestroyAvailableArea() 820 821``` 822NativeDisplayManager_ErrorCode OH_NativeDisplayManager_DestroyAvailableArea(NativeDisplayManager_Rect *availableArea) 823``` 824 825**描述** 826 827销毁屏幕的可用区域。 828 829**起始版本：** 20 830 831 832**参数：** 833 834| 参数项 | 描述 | 835| -- | -- | 836| [NativeDisplayManager_Rect](capi-nativedisplaymanager-rect.md) *availableArea | 销毁通过[OH_NativeDisplayManager_CreateAvailableArea](capi-oh-display-manager-h.md#oh_nativedisplaymanager_createavailablearea)获取的屏幕可用区域，<br>可用区域定义具体可见[NativeDisplayManager_Rect](capi-nativedisplaymanager-rect.md)。 | 837 838**返回：** 839 840| 类型 | 说明 | 841| -- | -- | 842| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 843 844### OH_NativeDisplayManager_DisplayAddCallback() 845 846``` 847typedef void (*OH_NativeDisplayManager_DisplayAddCallback)(uint64_t displayId) 848``` 849 850**描述** 851 852注册屏幕连接的回调函数。 853 854**起始版本：** 20 855 856 857**参数：** 858 859| 参数项 | 描述 | 860| -- | -- | 861| uint64_t displayId | 新增屏幕的id号，非负整数。 | 862 863### OH_NativeDisplayManager_RegisterDisplayAddListener() 864 865``` 866NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayAddListener(OH_NativeDisplayManager_DisplayAddCallback displayAddCallback, uint32_t *listenerIndex) 867``` 868 869**描述** 870 871注册屏幕连接变化监听（如插入显示器）。 872 873**起始版本：** 20 874 875 876**参数：** 877 878| 参数项 | 描述 | 879| -- | -- | 880| [OH_NativeDisplayManager_DisplayAddCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_displayaddcallback) displayAddCallback | 屏幕连接后触发的回调函数，回调函数定义见[OH_NativeDisplayManager_DisplayAddCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_displayaddcallback)。 | 881| uint32_t *listenerIndex | 注册成功后返回的监听编号，<br>调用取消注册函数[OH_NativeDisplayManager_UnregisterDisplayAddListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_unregisterdisplayaddlistener)时作为入参使用，此处作为出参返回。 | 882 883**返回：** 884 885| 类型 | 说明 | 886| -- | -- | 887| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 888 889### OH_NativeDisplayManager_UnregisterDisplayAddListener() 890 891``` 892NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayAddListener(uint32_t listenerIndex) 893``` 894 895**描述** 896 897取消屏幕连接的监听。 898 899**起始版本：** 20 900 901 902**参数：** 903 904| 参数项 | 描述 | 905| -- | -- | 906| uint32_t listenerIndex | 调用注册函数[OH_NativeDisplayManager_RegisterDisplayAddListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_registerdisplayaddlistener)时获取到的监听编号。 | 907 908**返回：** 909 910| 类型 | 说明 | 911| -- | -- | 912| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 913 914### OH_NativeDisplayManager_DisplayRemoveCallback() 915 916``` 917typedef void (*OH_NativeDisplayManager_DisplayRemoveCallback)(uint64_t displayId) 918``` 919 920**描述** 921 922注册屏幕移除的回调函数。 923 924**起始版本：** 20 925 926 927**参数：** 928 929| 参数项 | 描述 | 930| -- | -- | 931| uint64_t displayId | 被移除屏幕的id号，非负整数。 | 932 933### OH_NativeDisplayManager_RegisterDisplayRemoveListener() 934 935``` 936NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayRemoveListener(OH_NativeDisplayManager_DisplayRemoveCallback displayRemoveCallback, uint32_t *listenerIndex) 937``` 938 939**描述** 940 941注册屏幕移除变化监听（如移除显示器）。 942 943**起始版本：** 20 944 945 946**参数：** 947 948| 参数项 | 描述 | 949| -- | -- | 950| [OH_NativeDisplayManager_DisplayRemoveCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_displayremovecallback) displayRemoveCallback | 屏幕移除后触发的回调函数，回调函数定义见[OH_NativeDisplayManager_DisplayRemoveCallback](capi-oh-display-manager-h.md#oh_nativedisplaymanager_displayremovecallback)。 | 951| uint32_t *listenerIndex | 注册成功后返回的监听编号，<br>调用取消注册函数[OH_NativeDisplayManager_UnregisterDisplayRemoveListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_unregisterdisplayremovelistener)时作为入参使用，此处作为出参返回。 | 952 953**返回：** 954 955| 类型 | 说明 | 956| -- | -- | 957| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 958 959### OH_NativeDisplayManager_UnregisterDisplayRemoveListener() 960 961``` 962NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayRemoveListener(uint32_t listenerIndex) 963``` 964 965**描述** 966 967取消屏幕移除的监听。 968 969**起始版本：** 20 970 971 972**参数：** 973 974| 参数项 | 描述 | 975| -- | -- | 976| uint32_t listenerIndex | 调用注册函数[OH_NativeDisplayManager_RegisterDisplayRemoveListener](capi-oh-display-manager-h.md#oh_nativedisplaymanager_registerdisplayremovelistener)时获取到的监听编号。 | 977 978**返回：** 979 980| 类型 | 说明 | 981| -- | -- | 982| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 983 984### OH_NativeDisplayManager_GetDisplaySourceMode() 985 986``` 987NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDisplaySourceMode(uint64_t displayId, NativeDisplayManager_SourceMode *sourceMode) 988``` 989 990**描述** 991 992获取屏幕的显示模式。 993 994**起始版本：** 20 995 996 997**参数：** 998 999| 参数项 | 描述 | 1000| -- | -- | 1001| uint64_t displayId | 查询屏幕的id号，非负整数。 | 1002| [NativeDisplayManager_SourceMode](capi-oh-display-info-h.md#nativedisplaymanager_sourcemode) *sourceMode | 屏幕当前的显示模式，具体可见[NativeDisplayManager_SourceMode](capi-oh-display-info-h.md#nativedisplaymanager_sourcemode)，此处作为出参返回。 | 1003 1004**返回：** 1005 1006| 类型 | 说明 | 1007| -- | -- | 1008| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 | 1009 1010### OH_NativeDisplayManager_GetDisplayPosition() 1011 1012``` 1013NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDisplayPosition(uint64_t displayId, int32_t *x, int32_t *y) 1014``` 1015 1016**描述** 1017 1018获取屏幕的位置信息。 1019 1020**起始版本：** 20 1021 1022 1023**参数：** 1024 1025| 参数项 | 描述 | 1026| -- | -- | 1027| uint64_t displayId | 查询屏幕的id号，非负整数。 | 1028| int32_t *x | 相对于主屏左上角的x方向坐标，此处作为出参返回。 | 1029| int32_t *y | 相对于主屏左上角的y方向坐标，此处作为出参返回。 | 1030 1031**返回：** 1032 1033| 类型 | 说明 | 1034| -- | -- | 1035| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码，具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。<br>当前仅支持主屏幕和扩展屏幕查询屏幕位置信息，其他屏幕查询会返回DISPLAY_MANAGER_ERROR_ILLEGAL_PARAM。 | 1036 1037 1038