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**起始版本：** 3.1 43 44**返回：** 45 46HDF_SUCCESS 表示操作成功。 47 48HDF_FAILED 表示操作失败。 49 50 51### HoldRunningLock() 52 53``` 54IPowerInterface::HoldRunningLock ([in] struct RunningLockInfo info) 55``` 56**描述** 57持有运行锁，阻止设备休眠。 58 59**起始版本：** 4.0 60 61**参数:** 62 63| 名称 | 描述 | 64| -------- | -------- | 65| info | 输入参数，运行锁信息。 | 66 67**返回：** 68 69HDF_SUCCESS 表示操作成功。 70 71HDF_FAILED 表示操作失败。 72 73 74### PowerDump() 75 76``` 77IPowerInterface::PowerDump ([out] String info) 78``` 79**描述** 80获取电源的Dump信息。 81 82**起始版本：** 3.1 83 84**参数:** 85 86| 名称 | 描述 | 87| -------- | -------- | 88| info | 输出参数，电源的Dump信息。 | 89 90**返回：** 91 92HDF_SUCCESS 表示操作成功。 93 94HDF_FAILED 表示操作失败。 95 96 97### RegisterCallback() 98 99``` 100IPowerInterface::RegisterCallback ([in] IPowerHdiCallback ipowerHdiCallback) 101``` 102**描述** 103注册休眠/唤醒状态的回调。 104 105**起始版本：** 3.1 106 107**参数:** 108 109| 名称 | 描述 | 110| -------- | -------- | 111| ipowerHdiCallback | 输入参数，服务注册的回调。 | 112 113**返回：** 114 115HDF_SUCCESS 表示注册成功。 116 117HDF_FAILED 表示注册失败。 118 119**参见：** 120 121[IPowerHdiCallback](interface_i_power_hdi_callback_v11.md) 122 123 124### StartSuspend() 125 126``` 127IPowerInterface::StartSuspend () 128``` 129**描述** 130执行设备休眠操作。 131 132**起始版本：** 3.1 133 134**返回：** 135 136HDF_SUCCESS 表示操作成功。 137 138HDF_FAILED 表示操作失败。 139 140 141### StopSuspend() 142 143``` 144IPowerInterface::StopSuspend () 145``` 146**描述** 147执行设备唤醒操作。 148 149**起始版本：** 3.1 150 151**返回：** 152 153HDF_SUCCESS 表示操作成功。 154 155HDF_FAILED 表示操作失败。 156 157 158### SuspendBlock() 159 160``` 161IPowerInterface::SuspendBlock ([in] String name) 162``` 163**描述** 164打开运行锁，阻止休眠。 165 166**起始版本：** 3.1 167 168**参数:** 169 170| 名称 | 描述 | 171| -------- | -------- | 172| name | 输入参数，运行锁的名称。 | 173 174**返回：** 175 176HDF_SUCCESS 表示操作成功。 177 178HDF_FAILED 表示操作失败。 179 180 181### SuspendUnblock() 182 183``` 184IPowerInterface::SuspendUnblock ([in] String name) 185``` 186**描述** 187关闭运行锁，取消阻止休眠。 188 189**起始版本：** 3.1 190 191**参数:** 192 193| 名称 | 描述 | 194| -------- | -------- | 195| name | 输入参数，运行锁的名称。 | 196 197**返回：** 198 199HDF_SUCCESS 表示操作成功。 200 201HDF_FAILED 表示操作失败。 202 203 204### UnholdRunningLock() 205 206``` 207IPowerInterface::UnholdRunningLock ([in] struct RunningLockInfo info) 208``` 209**描述** 210解除运行锁，解除设备休眠。 211 212**起始版本：** 4.0 213 214**参数:** 215 216| 名称 | 描述 | 217| -------- | -------- | 218| info | 输入参数，运行锁信息。 | 219 220**返回：** 221 222HDF_SUCCESS 表示操作成功。 223 224HDF_FAILED 表示操作失败。 225