Metode IPowerPolicyCallbackWakeFromS0::OnArmWakeFromS0 (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.]

Lengan fungsi panggilan balik OnArmWakeFromS0 driver (yaitu, memungkinkan) perangkat sehingga dapat memicu sinyal bangun saat dalam status perangkat berdaya rendah, jika sistem tetap dalam status kerja sistem (S0).

Sintaks

HRESULT OnArmWakeFromS0(
  [in] IWDFDevice *pWdfDevice
);

Parameter

[in] pWdfDevice

Penunjuk ke antarmuka IWDFDevice objek perangkat yang mewakili salah satu perangkat driver.

Nilai kembali

Jika operasi berhasil, fungsi panggilan balik OnArmWakeFromS0 harus mengembalikan S_OK atau nilai status lain yang SUCCEEDED(statusnya) sama dengan TRUE. Jika tidak, itu harus mengembalikan nilai status yang SUCCEEDED(status) sama dengan FALSE.

Jika SUCCEEDED(status) sama dengan FALSE, kerangka kerja memanggil fungsi panggilan balik IPowerPolicyCallbackWakeFromS0::OnDisarmWakeFromS0 driver. (Kerangka kerja tidak melaporkan kegagalan perangkat ke manajer PnP.)

Keterangan

Driver Anda harus menyediakan fungsi panggilan balik OnArmWakeFromS0 jika driver mendukung antarmuka IPowerPolicyCallbackWakeFromS0 .

Fungsi panggilan balik OnArmWakeFromS0 menangani operasi khusus perangkat yang diperlukan untuk memungkinkan perangkat mendeteksi peristiwa eksternal yang memicu sinyal bangun di bus. Driver bus mode kernel menangani operasi khusus bus, seperti mengaktifkan sinyal Power Management Event (PME) bus PCI.

Jika driver telah mendaftarkan fungsi panggilan balik OnArmWakeFromS0 , 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.

Prosesnya terjadi dalam urutan berikut:

Kerangka kerja menentukan bahwa perangkat telah menganggur selama jangka waktu yang telah ditetapkan sebelumnya.
Kerangka kerja memanggil fungsi panggilan balik OnArmWakeFromS0 driver.
Kerangka kerja meminta driver untuk bus perangkat untuk menurunkan daya perangkat.

Segera sebelum perangkat Anda memasuki status daya rendah, kerangka kerja akan memanggil fungsi panggilan balik IPnpCallback::OnD0Exit driver Anda.

Untuk informasi selengkapnya tentang kapan kerangka kerja memanggil fungsi panggilan balik ini, lihat Skenario PnP dan Power Management di UMDF.

Anda tidak perlu menyediakan fungsi panggilan balik OnArmWakeFromS0 jika perangkat Anda:

Adalah perangkat USB yang mendukung "suspensi selektif."
Tidak dapat dimatikan saat sistem tetap didukung penuh.
Tidak memerlukan operasi perangkat keras khusus yang memungkinkan perangkat memicu sinyal bangun.

Jika perangkat Anda mendukung USB "suspensi selektif" dan jika driver Anda menentukan IdleUsbSelectiveSuspend saat memanggil IWDFDevice2::AssignS0IdleSettings, kerangka kerja mengirimkan permintaan "penangguhan selektif" ke driver bus USB ketika perangkat telah menganggur untuk jumlah waktu yang telah ditetapkan.

Untuk informasi selengkapnya tentang fungsi panggilan balik ini, lihat Mendukung Power-Down Menganggur 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

IPowerPolicyCallbackWakeFromS0

IPowerPolicyCallbackWakeFromS0::OnDisarmWakeFromS0

IPowerPolicyCallbackWakeFromS0::OnWakeFromS0Triggered

Bagikan melalui