fungsi panggilan balik D3COLD_REQUEST_AUX_POWER (wdm.h)

Artikel
07/02/2025

Memungkinkan objek perangkat fungsi (FDO) untuk menyampaikan persyaratan daya tambahannya.

Sintaksis

C++

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

NTSTATUS D3coldRequestAuxPower(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG AuxPowerInMilliWatts,
  [_Out_]                                     PULONG RetryInSeconds
)
{...}

Parameter

Context

Handel ke perangkat.

[_In_] AuxPowerInMilliWatts

Watt dalam unit mW yang dibutuhkan perangkat untuk D3cold ketika sistem berada di S0. Nilai ini harus kurang dari 0x80000000.

[_Out_] RetryInSeconds

Penunjuk ke variabel ULONG yang menerima jumlah detik driver dapat mencoba kembali permintaannya ketika permintaan gagal dengan STATUS_RETRY.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, kembalikan kode kesalahan Nilai NTSTATUS yang sesuai. Untuk informasi selengkapnya, lihat nilai NTSTATUS. Kemungkinan kesalahan adalah sebagai berikut:

Kode kesalahan	Deskripsi
STATUS_INVALID_PARAMETER	Parameter input tidak valid.
STATUS_INVALID_DEVICE_REQUEST	Perangkat tidak dalam D0 atau bukan pemohon bukan Fungsi 0.
STATUS_RETRY	Permintaan gagal dan sistem menunjukkan bahwa coba lagi dapat dilakukan. RetryInSeconds akan berisi jumlah detik driver harus menunggu sebelum membuat permintaan berikutnya.
STATUS_UNSUCCESSFUL	Permintaan gagal dan sistem menunjukkan bahwa nilai yang diminta saat ini tidak dimungkinkan.
STATUS_SUCCESS	Permintaan berhasil.

Komentar

Driver perangkat yang berhasil meminta antarmuka GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE menerima penunjuk ke struktur D3COLD_AUX_POWER_AND_TIMING_INTERFACE di mana driver mengatur anggota RequestAuxPower ke penunjuk ke implementasi fungsi panggilan balik D3COLD_REQUEST_AUX_POWER.

Untuk perangkat multifungsi, hanya Fungsi 0 yang diharapkan untuk memanggil rutinitas ini dan mengatur daya tambahan untuk seluruh perangkat.
Fungsi 0 harus dalam status D0 ketika rutinitas ini dipanggil.
Tidak ada jaminan bahwa daya rel daya inti akan dihapus setelah keberhasilan permintaan ini.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 10, versi 1803
Header	wdm.h (termasuk Wdm.h)

Bagikan melalui