Fungsi DevicePowerEnumDevices (powrprof.h)

  • Artikel

Menghitung perangkat pada sistem yang memenuhi kriteria yang ditentukan.

Sintaks

BOOLEAN DevicePowerEnumDevices(
  [in]            ULONG  QueryIndex,
  [in]            ULONG  QueryInterpretationFlags,
  [in]            ULONG  QueryFlags,
  [out, optional] PBYTE  pReturnBuffer,
  [in, out]       PULONG pBufferSize
);

Parameter

[in] QueryIndex

Indeks perangkat yang diminta. Untuk panggilan awal, nilai ini harus nol.

[in] QueryInterpretationFlags

Kriteria diterapkan ke hasil pencarian.

Nilai Makna
DEVICEPOWER_HARDWAREID
0x80000000
 Mengembalikan string ID perangkat keras daripada nama perangkat yang mudah diingat.
DEVICEPOWER_FILTER_DEVICES_PRESENT
0x20000000
 Abaikan perangkat yang saat ini tidak ada dalam sistem.
DEVICEPOWER_AND_OPERATION
0x40000000
 Lakukan operasi AND pada QueryFlags.
DEVICEPOWER_FILTER_WAKEENABLED
0x08000000
 Periksa apakah perangkat saat ini diaktifkan untuk membangunkan sistem dari status tidur.
DEVICEPOWER_FILTER_ON_NAME
0x02000000
 Temukan perangkat yang namanya cocok dengan string yang diteruskan di pReturnBuffer dan periksa kemampuannya terhadap QueryFlags.

[in] QueryFlags

Kriteria kueri.

Nilai Makna
PDCAP_D0_SUPPORTED
0x00000001
 Perangkat mendukung status daya sistem D0.
PDCAP_D1_SUPPORTED
0x00000002
 Perangkat mendukung status daya sistem D1.
PDCAP_D2_SUPPORTED
0x00000004
 Perangkat mendukung status daya sistem D2.
PDCAP_D3_SUPPORTED
0x00000008
 Perangkat mendukung status daya sistem D3.
PDCAP_S0_SUPPORTED
0x00010000
 Perangkat mendukung status tidur sistem S0.
PDCAP_S1_SUPPORTED
0x00020000
 Perangkat mendukung status tidur sistem S1.
PDCAP_S2_SUPPORTED
0x00040000
 Perangkat mendukung status tidur sistem S2.
PDCAP_S3_SUPPORTED
0x00080000
 Perangkat mendukung status tidur sistem S3.
PDCAP_S4_SUPPORTED
0x01000000
 Perangkat mendukung status tidur sistem S4.
PDCAP_S5_SUPPORTED
0x02000000
 Perangkat ini mendukung status tidur sistem S5.
PDCAP_WAKE_FROM_D0_SUPPORTED
0x00000010
 Perangkat mendukung bangun dari status daya sistem D0.
PDCAP_WAKE_FROM_D1_SUPPORTED
0x00000020
 Perangkat mendukung bangun dari status daya sistem D1.
PDCAP_WAKE_FROM_D2_SUPPORTED
0x00000040
 Perangkat mendukung bangun dari status daya sistem D2.
PDCAP_WAKE_FROM_D3_SUPPORTED
0x00000080
 Perangkat mendukung bangun dari status daya sistem D3.
PDCAP_WAKE_FROM_S0_SUPPORTED
0x00100000
 Perangkat mendukung bangun dari status tidur sistem S0.
PDCAP_WAKE_FROM_S1_SUPPORTED
0x00200000
 Perangkat mendukung bangun dari status tidur sistem S1.
PDCAP_WAKE_FROM_S2_SUPPORTED
0x00400000
 Perangkat mendukung bangun dari status tidur sistem S2.
PDCAP_WAKE_FROM_S3_SUPPORTED
0x00800000
 Perangkat mendukung bangun dari status tidur sistem S3.
PDCAP_WARM_EJECT_SUPPORTED
0x00000100
 Perangkat mendukung lonjakan hangat.

[out, optional] pReturnBuffer

Penunjuk ke buffer yang menerima informasi yang diminta.

[in, out] pBufferSize

Ukuran, dalam byte, dari buffer kembali.

Catatan Jika pReturnBufferADALAH NULL, pBufferSize akan diisi dengan ukuran yang diperlukan untuk mengembalikan data.
 

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Nilai parameter QueryFlags dapat digabungkan untuk mengkueri perangkat yang mendukung dua kriteria atau lebih. Misalnya; jika PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED diteruskan sebagai parameter QueryFlags , fungsi akan meminta perangkat yang mendukung D3 atau D1.

QueryFlags juga dapat dikombinasikan dengan QueryInterpretationFlags yang diatur ke DEVICEPOWER_AND_OPERATION untuk menghasilkan kueri perangkat yang mendukung semua kriteria yang diminta. Misalnya; jika PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED diteruskan sebagai parameter QueryFlags dan DEVICEPOWER_AND_OPERATION diteruskan sebagai parameter QueryInterpretationFlags , fungsi akan meminta perangkat yang mendukung D3 dan D1.

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Menggunakan Api Daya Perangkat.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header powrprof.h
Pustaka PowrProf.lib
DLL PowrProf.dll

Lihat juga

Manajemen Daya Perangkat