Metode IWDFDevice2::GetSystemPowerAction (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode GetSystemPowerAction mengembalikan tindakan daya sistem, jika ada, yang saat ini terjadi untuk komputer.
Sintaks
POWER_ACTION GetSystemPowerAction();
Mengembalikan nilai
GetSystemPowerAction mengembalikan nilai enumerator yang ditik POWER_ACTION. Nilai menunjukkan tindakan daya sistem yang saat ini terjadi untuk komputer. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
Keterangan
Metode GetSystemPowerAction memungkinkan driver untuk menentukan apakah transisi daya perangkat terjadi karena perangkat menganggur (atau bangun), atau karena seluruh komputer memasuki (atau meninggalkan) status daya rendah.
Driver harus memanggil GetSystemPowerAction hanya dari fungsi panggilan balik peristiwa yang dipanggil kerangka kerja saat perangkat memasuki status daya rendah atau kembali ke status kerjanya.
Nilai yang dikembalikan GetSystemPowerAction bergantung pada situasi berikut:
- Jika komputer memasuki status daya rendah ketika driver memanggil GetSystemPowerAction, metode mengembalikan alasan komputer memasuki status daya rendah. Misalnya, metode mengembalikan PowerActionSleep jika komputer memasuki status daya rendah S1, S2, atau S3.
- Jika komputer kembali ke status kerjanya (S0) dari status daya rendah ketika driver memanggil GetSystemPowerAction, metode mengembalikan alasan komputer memasuki status daya rendah. Misalnya, metode mengembalikan PowerActionSleep jika komputer meninggalkan status daya rendah S1, S2, atau S3.
- Jika komputer menyala (setelah dimatikan) ketika driver memanggil GetSystemPowerAction, metode mengembalikan PowerActionNone.
- Jika perangkat memasuki status diam berdaya rendah atau kembali ke status kerjanya (D0) saat driver memanggil GetSystemPowerAction, sementara sistem lainnya tetap pada status kerjanya (S0), metode mengembalikan PowerActionNone.
- Jika komputer dan perangkat berada dalam status kerjanya ketika driver memanggil GetSystemPowerAction, metode mengembalikan PowerActionNone.
Contoh
Contoh kode berikut mendapatkan antarmuka IWDFDevice2 lalu memanggil GetSystemPowerAction.
IWDFDevice2 *pDevice2 = NULL;
HRESULT hrQI = pDevice->QueryInterface(IID_PPV_ARGS(&pDevice2));
if (SUCCEEDED(hrQI))
{
POWER_ACTION powerAction = pDevice2->GetSystemPowerAction();
}
...
SAFE_RELEASE(pDevice2);
Persyaratan
Persyaratan | Nilai |
---|---|
Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
Target Platform | Desktop |
Versi UMDF minimum | 1.9 |
Header | wudfddi.h (termasuk Wudfddi.h) |
DLL | WUDFx.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk