1# IPowerInterface
2
3
4## 概述
5
6休眠/唤醒操作、订阅休眠/唤醒状态、运行锁管理的接口。
7
8服务获取此对象后，可以调用相关的接口对设备进行休眠/唤醒、订阅休眠/唤醒状态和管理运行锁。
9
10**起始版本：** 3.1
11
12**相关模块：**[Power](power_v10.md)
13
14
15## 汇总
16
17
18### Public 成员函数
19
20| 名称 | 描述 |
21| -------- | -------- |
22| [RegisterCallback](#registercallback) ([in] [IPowerHdiCallback](interface_i_power_hdi_callback_v10.md) ipowerHdiCallback) | 注册休眠/唤醒状态的回调。  |
23| [StartSuspend](#startsuspend) () | 执行设备休眠操作。  |
24| [StopSuspend](#stopsuspend) () | 执行设备唤醒操作。  |
25| [ForceSuspend](#forcesuspend) () | 执行设备强制休眠操作。  |
26| [SuspendBlock](#suspendblock) ([in] String name) | 打开运行锁，阻止休眠。  |
27| [SuspendUnblock](#suspendunblock) ([in] String name) | 关闭运行锁，取消阻止休眠。  |
28| [PowerDump](#powerdump) ([out] String info) | 获取电源的Dump信息。  |
29
30
31## 成员函数说明
32
33
34### ForceSuspend()
35
36```
37IPowerInterface::ForceSuspend ()
38```
39**描述**
40
41执行设备强制休眠操作。
42
43**起始版本：** 3.1
44
45**返回：**
46
47HDF_SUCCESS 表示操作成功。
48
49HDF_FAILED 表示操作失败。
50
51
52### PowerDump()
53
54```
55IPowerInterface::PowerDump ([out] String info)
56```
57**描述**
58
59获取电源的Dump信息。
60
61**起始版本：** 3.1
62
63**参数:**
64
65| 名称 | 描述 |
66| -------- | -------- |
67| info | 输出参数，电源的Dump信息。 |
68
69**返回：**
70
71HDF_SUCCESS 表示操作成功。
72
73HDF_FAILED 表示操作失败。
74
75
76### RegisterCallback()
77
78```
79IPowerInterface::RegisterCallback ([in] IPowerHdiCallback ipowerHdiCallback)
80```
81**描述**
82
83注册休眠/唤醒状态的回调。
84
85**起始版本：** 3.1
86
87**参数:**
88
89| 名称 | 描述 |
90| -------- | -------- |
91| ipowerHdiCallback | 输入参数，服务注册的回调。 |
92
93**返回：**
94
95HDF_SUCCESS 表示操作成功。
96
97HDF_FAILED 表示操作失败。
98
99**参见：**
100
101[IPowerHdiCallback](interface_i_power_hdi_callback_v10.md)
102
103
104### StartSuspend()
105
106```
107IPowerInterface::StartSuspend ()
108```
109**描述**
110
111执行设备休眠操作。
112
113**起始版本：** 3.1
114
115**返回：**
116
117HDF_SUCCESS 表示操作成功。
118
119HDF_FAILED 表示操作失败。
120
121
122### StopSuspend()
123
124```
125IPowerInterface::StopSuspend ()
126```
127**描述**
128
129执行设备唤醒操作。
130
131**起始版本：** 3.1
132
133**返回：**
134
135HDF_SUCCESS 表示操作成功。
136
137HDF_FAILED 表示操作失败。
138
139
140### SuspendBlock()
141
142```
143IPowerInterface::SuspendBlock ([in] String name)
144```
145**描述**
146
147打开运行锁，阻止休眠。
148
149**起始版本：** 3.1
150
151**参数:**
152
153| 名称 | 描述 |
154| -------- | -------- |
155| name | 输入参数，运行锁的名称。 |
156
157**返回：**
158
159HDF_SUCCESS 表示操作成功。
160
161HDF_FAILED 表示操作失败。
162
163
164### SuspendUnblock()
165
166```
167IPowerInterface::SuspendUnblock ([in] String name)
168```
169**描述**
170
171关闭运行锁，取消阻止休眠。
172
173**起始版本：** 3.1
174
175**参数:**
176
177| 名称 | 描述 |
178| -------- | -------- |
179| name | 输入参数，运行锁的名称。 |
180
181**返回：**
182
183HDF_SUCCESS 表示操作成功。
184
185HDF_FAILED 表示操作失败。
186