通过

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

请参阅

设备电源管理