Metode IWDFDevice2::GetSystemPowerAction (wudfddi.h)

Artikel
03/08/2023

[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.

Untuk informasi selengkapnya tentang status berdaya rendah, lihat Perangkat Memasuki Status Low-Power.

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

IWDFDevice2

Bagikan melalui