• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# oh_display_capture.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_capture.h>
14
15**库:** libnative_display_manager.so
16
17**系统能力:** SystemCapability.WindowManager.WindowManager.Core
18
19**起始版本:** 14
20
21**相关模块:** [OH_DisplayManager](capi-oh-displaymanager.md)
22
23## 汇总
24
25### 函数
26
27| 名称 | 描述 |
28| -- | -- |
29| [NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CaptureScreenPixelmap(uint32_t displayId,OH_PixelmapNative **pixelMap)](#oh_nativedisplaymanager_capturescreenpixelmap) | 获取屏幕全屏截图,可以通过设置不同的屏幕id号截取不同屏幕的截图。 |
30
31## 函数说明
32
33### OH_NativeDisplayManager_CaptureScreenPixelmap()
34
35```
36NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CaptureScreenPixelmap(uint32_t displayId,OH_PixelmapNative **pixelMap)
37```
38
39**描述**
40
41获取屏幕全屏截图,可以通过设置不同的屏幕id号截取不同屏幕的截图。
42
43**需要权限:** ohos.permission.CUSTOM_SCREEN_CAPTURE
44
45**起始版本:** 14
46
47**设备行为差异:** 该接口在2in1设备、Tablet设备中可正常调用,在其他设备中返回801错误码。
48
49**参数:**
50
51| 参数项 | 描述 |
52| -- | -- |
53| uint32_t displayId | 需要截屏的屏幕id号,该值为非负整数。 |
54| [OH_PixelmapNative](../apis-image-kit/capi-image-nativemodule-oh-pixelmapnative.md) **pixelMap | 创建指定屏幕id的OH_PixelmapNative对象,此处作为出参返回。 |
55
56**返回:**
57
58| 类型 | 说明 |
59| -- | -- |
60| [NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode) | 返回屏幕管理接口的通用状态码,具体可见[NativeDisplayManager_ErrorCode](capi-oh-display-info-h.md#nativedisplaymanager_errorcode)。 |
61
62
63