1# IPowerInterface
2
3
4## 概述
5
6休眠/唤醒操作、订阅休眠/唤醒状态、运行锁管理的接口。
7
8**起始版本：** 3.1
9
10**相关模块：**[Power](power_v11.md)
11
12
13## 汇总
14
15
16### Public 成员函数
17
18| 名称 | 描述 |
19| -------- | -------- |
20| [RegisterCallback](#registercallback) ([in] [IPowerHdiCallback](interface_i_power_hdi_callback_v11.md) ipowerHdiCallback) | 注册休眠/唤醒状态的回调。  |
21| [StartSuspend](#startsuspend) () | 执行设备休眠操作。  |
22| [StopSuspend](#stopsuspend) () | 执行设备唤醒操作。  |
23| [ForceSuspend](#forcesuspend) () | 执行设备强制休眠操作。  |
24| [SuspendBlock](#suspendblock) ([in] String name) | 打开运行锁，阻止休眠。  |
25| [SuspendUnblock](#suspendunblock) ([in] String name) | 关闭运行锁，取消阻止休眠。  |
26| [PowerDump](#powerdump) ([out] String info) | 获取电源的Dump信息。  |
27| [HoldRunningLock](#holdrunninglock) ([in] struct [RunningLockInfo](_running_lock_info_v11.md) info) | 持有运行锁，阻止设备休眠。  |
28| [UnholdRunningLock](#unholdrunninglock) ([in] struct [RunningLockInfo](_running_lock_info_v11.md) info) | 解除运行锁，解除设备休眠。  |
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### HoldRunningLock()
53
54```
55IPowerInterface::HoldRunningLock ([in] struct RunningLockInfo info)
56```
57**描述**
58
59持有运行锁，阻止设备休眠。
60
61**起始版本：** 4.0
62
63**参数:**
64
65| 名称 | 描述 |
66| -------- | -------- |
67| info | 输入参数，运行锁信息。 |
68
69**返回：**
70
71HDF_SUCCESS 表示操作成功。
72
73HDF_FAILED 表示操作失败。
74
75
76### PowerDump()
77
78```
79IPowerInterface::PowerDump ([out] String info)
80```
81**描述**
82
83获取电源的Dump信息。
84
85**起始版本：** 3.1
86
87**参数:**
88
89| 名称 | 描述 |
90| -------- | -------- |
91| info | 输出参数，电源的Dump信息。 |
92
93**返回：**
94
95HDF_SUCCESS 表示操作成功。
96
97HDF_FAILED 表示操作失败。
98
99
100### RegisterCallback()
101
102```
103IPowerInterface::RegisterCallback ([in] IPowerHdiCallback ipowerHdiCallback)
104```
105**描述**
106
107注册休眠/唤醒状态的回调。
108
109**起始版本：** 3.1
110
111**参数:**
112
113| 名称 | 描述 |
114| -------- | -------- |
115| ipowerHdiCallback | 输入参数，服务注册的回调。 |
116
117**返回：**
118
119HDF_SUCCESS 表示注册成功。
120
121HDF_FAILED 表示注册失败。
122
123**参见：**
124
125[IPowerHdiCallback](interface_i_power_hdi_callback_v11.md)
126
127
128### StartSuspend()
129
130```
131IPowerInterface::StartSuspend ()
132```
133**描述**
134
135执行设备休眠操作。
136
137**起始版本：** 3.1
138
139**返回：**
140
141HDF_SUCCESS 表示操作成功。
142
143HDF_FAILED 表示操作失败。
144
145
146### StopSuspend()
147
148```
149IPowerInterface::StopSuspend ()
150```
151**描述**
152
153执行设备唤醒操作。
154
155**起始版本：** 3.1
156
157**返回：**
158
159HDF_SUCCESS 表示操作成功。
160
161HDF_FAILED 表示操作失败。
162
163
164### SuspendBlock()
165
166```
167IPowerInterface::SuspendBlock ([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
187
188### SuspendUnblock()
189
190```
191IPowerInterface::SuspendUnblock ([in] String name)
192```
193**描述**
194
195关闭运行锁，取消阻止休眠。
196
197**起始版本：** 3.1
198
199**参数:**
200
201| 名称 | 描述 |
202| -------- | -------- |
203| name | 输入参数，运行锁的名称。 |
204
205**返回：**
206
207HDF_SUCCESS 表示操作成功。
208
209HDF_FAILED 表示操作失败。
210
211
212### UnholdRunningLock()
213
214```
215IPowerInterface::UnholdRunningLock ([in] struct RunningLockInfo info)
216```
217**描述**
218
219解除运行锁，解除设备休眠。
220
221**起始版本：** 4.0
222
223**参数:**
224
225| 名称 | 描述 |
226| -------- | -------- |
227| info | 输入参数，运行锁信息。 |
228
229**返回：**
230
231HDF_SUCCESS 表示操作成功。
232
233HDF_FAILED 表示操作失败。
234