devicePowerEnumDevices 函数 (powrprof.h)
枚举系统上满足指定条件的设备。
语法
BOOLEAN DevicePowerEnumDevices(
[in] ULONG QueryIndex,
[in] ULONG QueryInterpretationFlags,
[in] ULONG QueryFlags,
[out, optional] PBYTE pReturnBuffer,
[in, out] PULONG pBufferSize
);
parameters
[in] QueryIndex
所请求设备的索引。 对于初始调用，此值应为零。
[in] QueryInterpretationFlags
应用于搜索结果的条件。
| 值 |
含义 |
- DEVICEPOWER_HARDWAREID
- 0x80000000
|
返回硬件 ID 字符串，而不是友好设备名称。
|
- DEVICEPOWER_FILTER_DEVICES_PRESENT
- 0x20000000
|
忽略系统中当前不存在的设备。
|
- DEVICEPOWER_AND_OPERATION
- 0x40000000
|
对 QueryFlags 执行 AND 操作。
|
- DEVICEPOWER_FILTER_WAKEENABLED
- 0x08000000
|
检查设备当前是否已启用以将系统从睡眠状态唤醒。
|
- DEVICEPOWER_FILTER_ON_NAME
- 0x02000000
|
查找名称与 pReturnBuffer 中传递的字符串匹配的设备，并针对 QueryFlags 检查其功能。
|
[in] QueryFlags
查询条件。
| 值 |
含义 |
- PDCAP_D0_SUPPORTED
- 0x00000001
|
设备支持系统电源状态 D0。
|
- PDCAP_D1_SUPPORTED
- 0x00000002
|
设备支持系统电源状态 D1。
|
- PDCAP_D2_SUPPORTED
- 0x00000004
|
设备支持系统电源状态 D2。
|
- PDCAP_D3_SUPPORTED
- 0x00000008
|
设备支持系统电源状态 D3。
|
- PDCAP_S0_SUPPORTED
- 0x00010000
|
设备支持系统睡眠状态 S0。
|
- PDCAP_S1_SUPPORTED
- 0x00020000
|
设备支持系统睡眠状态 S1。
|
- PDCAP_S2_SUPPORTED
- 0x00040000
|
设备支持系统睡眠状态 S2。
|
- PDCAP_S3_SUPPORTED
- 0x00080000
|
设备支持系统睡眠状态 S3。
|
- PDCAP_S4_SUPPORTED
- 0x01000000
|
设备支持系统睡眠状态 S4。
|
- PDCAP_S5_SUPPORTED
- 0x02000000
|
设备支持系统睡眠状态 S5。
|
- PDCAP_WAKE_FROM_D0_SUPPORTED
- 0x00000010
|
设备支持从系统电源状态 D0 唤醒。
|
- PDCAP_WAKE_FROM_D1_SUPPORTED
- 0x00000020
|
设备支持从系统电源状态 D1 唤醒。
|
- PDCAP_WAKE_FROM_D2_SUPPORTED
- 0x00000040
|
设备支持从系统电源状态 D2 唤醒。
|
- PDCAP_WAKE_FROM_D3_SUPPORTED
- 0x00000080
|
设备支持从系统电源状态 D3 唤醒。
|
- PDCAP_WAKE_FROM_S0_SUPPORTED
- 0x00100000
|
设备支持从系统睡眠状态 S0 唤醒。
|
- PDCAP_WAKE_FROM_S1_SUPPORTED
- 0x00200000
|
设备支持从系统睡眠状态 S1 唤醒。
|
- PDCAP_WAKE_FROM_S2_SUPPORTED
- 0x00400000
|
设备支持从系统睡眠状态 S2 唤醒。
|
- PDCAP_WAKE_FROM_S3_SUPPORTED
- 0x00800000
|
设备支持从系统睡眠状态 S3 唤醒。
|
- PDCAP_WARM_EJECT_SUPPORTED
- 0x00000100
|
设备支持热弹出。
|
[out, optional] pReturnBuffer
指向接收所请求信息的缓冲区的指针。
[in, out] pBufferSize
返回缓冲区的大小（以字节为单位）。
注意 如果 pReturnBuffer 为 NULL，则 pBufferSize 将填充返回数据所需的大小。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。
QueryFlags 参数的值可以组合在一起，以查询支持两个或多个条件的设备。 例如：如果 PDCAP_D3_SUPPORTED |
PDCAP_D1_SUPPORTED 作为 QueryFlags 参数传递，则函数将查询支持 D3 或 D1 的设备。
QueryFlags 还可以与设置为 DEVICEPOWER_AND_OPERATION 的 QueryInterpretationFlags 结合使用，以生成支持所有请求条件的设备查询。 例如：如果 PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED 作为 QueryFlags 参数传递， DEVICEPOWER_AND_OPERATION 作为 QueryInterpretationFlags 参数传递，则函数将查询同时支持 D3 和 D1 的设备。
示例
有关使用此函数的示例，请参阅 使用设备 Power API。
要求
| |
|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 目标平台 |
Windows |
| 标头 |
powrprof.h |
| Library |
PowrProf.lib |
| DLL |
PowrProf.dll |
请参阅
设备电源管理