Metode IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (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.]
Lengan fungsi panggilan balik peristiwa OnArmWakeFromSx driver (yaitu, mengaktifkan) perangkat sehingga dapat memicu sinyal bangun saat dalam keadaan perangkat berdaya rendah. Sinyal bangun menyebabkan perangkat memasuki status kerjanya (D0) dan sistem memasuki status kerjanya (S0).
Sintaks
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
Parameter
[in] pWdfDevice
Penunjuk ke antarmuka IWDFDevice dari objek perangkat yang mewakili salah satu perangkat driver.
Nilai kembali
Jika operasi berhasil, fungsi panggilan balik OnArmWakeFromSx harus mengembalikan S_OK atau nilai status lain yang SUCCEEDED(statusnya) sama dengan TRUE. Jika tidak, nilai status harus dikembalikan yang SUCCEEDED(statusnya) sama dengan FALSE.
Jika SUCCEEDED(status) sama dengan FALSE, kerangka kerja memanggil fungsi panggilan balik IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx driver. (Kerangka kerja tidak melaporkan kegagalan perangkat ke manajer PnP.)
Keterangan
Driver Anda harus menyediakan fungsi panggilan balik OnArmWakeFromSx jika driver mendukung antarmuka IPowerPolicyCallbackWakeFromSx .
Fungsi panggilan balik ini menangani operasi khusus perangkat yang diperlukan untuk memungkinkan perangkat mendeteksi peristiwa eksternal yang memicu sinyal bangun di bus. Pengemudi bus mode kernel menangani operasi khusus bus, seperti mengaktifkan sinyal Power Management Event (PME) bus PCI.
Jika driver telah mendaftarkan fungsi panggilan balik OnArmWakeFromSx , kerangka kerja memanggilnya saat perangkat masih dalam status daya perangkat D0, sebelum driver bus menurunkan status daya perangkat tetapi setelah kerangka kerja mengirim IRP tunggu/bangun atas nama driver.
Proses ini terjadi dalam urutan berikut:
- Kerangka kerja menentukan bahwa sistem akan memasuki status sistem berdaya rendah.
- Kerangka kerja memanggil fungsi panggilan balik OnArmWakeFromSx driver.
- Kerangka kerja meminta bus perangkat untuk menurunkan daya perangkat.
Untuk informasi selengkapnya tentang kapan kerangka kerja memanggil fungsi panggilan balik ini, lihat Skenario Manajemen PnP dan Power di UMDF.
Anda tidak perlu menyediakan fungsi panggilan balik OnArmWakeFromSx jika perangkat Anda tidak memerlukan operasi perangkat keras khusus yang memungkinkan perangkat memicu sinyal bangun.
Untuk informasi selengkapnya tentang fungsi panggilan balik ini, lihat Wake-Up Sistem Pendukung di Driver berbasis UMDF.
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) |
Lihat juga
IPowerPolicyCallbackWakeFromSx