EVT_WDF_DEVICE_ARM_WAKE_FROM_SX fungsi panggilan balik (wdfdevice.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Lengan fungsi panggilan balik peristiwa EvtDeviceArmWakeFromSx driver (yaitu, mengaktifkan) perangkat sehingga dapat memicu sinyal bangun saat dalam status perangkat berdaya rendah. Sinyal bangun menyebabkan perangkat memasuki status kerjanya (D0) dan menyebabkan sistem memasuki status kerja (S0).

Sintaks

EVT_WDF_DEVICE_ARM_WAKE_FROM_SX EvtWdfDeviceArmWakeFromSx;

NTSTATUS EvtWdfDeviceArmWakeFromSx(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

Jika fungsi panggilan balik EvtDeviceArmWakeFromSx tidak mengalami kesalahan, fungsi tersebut harus mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(statusnya) sama dengan TRUE. Jika tidak, itu harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.

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

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtDeviceArmWakeFromSx , driver harus memanggil WdfDeviceInitSetPowerPolicyEventCallbacks. Driver dapat mendaftarkan fungsi panggilan balik EvtDeviceArmWakeFromSx atau fungsi panggilan balik EvtDeviceArmWakeFromSxWithReason , tetapi tidak keduanya.

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

Jika driver telah mendaftarkan fungsi panggilan balik EvtDeviceArmWakeFromSx atau EvtDeviceArmWakeFromSxWithReason , 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 sistem akan memasuki status sistem berdaya rendah.
Kerangka kerja memanggil fungsi panggilan balik EvtDeviceArmWakeFromSx atau EvtDeviceArmWakeFromSxWithReason driver.
Kerangka kerja meminta driver untuk bus perangkat menurunkan daya perangkat.

Segera sebelum perangkat memasuki status daya rendah, kerangka kerja memanggil fungsi panggilan balik EvtDeviceD0Exit driver.

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

Anda tidak perlu menyediakan fungsi panggilan balik EvtDeviceArmWakeFromSx atau EvtDeviceArmWakeFromSxWithReason jika perangkat Anda tidak memerlukan operasi perangkat keras khusus yang memungkinkan perangkat memicu sinyal bangun.

Untuk informasi selengkapnya tentang fungsi panggilan balik ini, lihat Mendukung Wake-Up Sistem.