DevicePowerEnumDevices 函式 (powrprof.h)
列舉系統上符合指定準則的裝置。
語法
BOOLEAN DevicePowerEnumDevices(
[in] ULONG QueryIndex,
[in] ULONG QueryInterpretationFlags,
[in] ULONG QueryFlags,
[out, optional] PBYTE pReturnBuffer,
[in, out] PULONG pBufferSize
);
參數
[in] QueryIndex
所要求裝置的索引。 針對初始呼叫，此值應為零。
[in] QueryInterpretationFlags
套用至搜尋結果的準則。
| 值 |
意義 |
- DEVICEPOWER_HARDWAREID
- 0x80000000
|
傳回硬體識別碼字串，而不是易記的裝置名稱。
|
- 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 的裝置。
範例
如需使用此函式的範例，請參閱 使用裝置電源 API。
需求
| |
|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 |
Windows |
| 標頭 |
powrprof.h |
| 程式庫 |
PowrProf.lib |
| Dll |
PowrProf.dll |
另請參閱
裝置電源管理