共用方式為

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

另請參閱

裝置電源管理