Fungsi PoFxSetComponentResidency (wdm.h)

Rutinitas PoFxSetComponentResidency menetapkan perkiraan waktu untuk berapa lama komponen kemungkinan akan tetap menganggur setelah komponen memasuki kondisi menganggur.

Sintaks

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

Parameter

[in] Handle

Handel yang mewakili pendaftaran perangkat dengan kerangka kerja manajemen daya (PoFx). Driver perangkat sebelumnya menerima handel ini dari rutinitas PoFxRegisterDevice .

[in] Component

Indeks yang mengidentifikasi komponen. Parameter ini adalah indeks ke dalam array Komponen dalam struktur PO_FX_DEVICE yang digunakan driver perangkat untuk mendaftarkan perangkat dengan PoFx. Jika array Komponen berisi elemen N, indeks komponen berkisar antara 0 hingga N–1.

[in] Residency

Perkiraan waktu residensi, dalam 100 unit nanodetik. Parameter ini adalah petunjuk untuk PoFx tentang berapa lama komponen cenderung tetap menganggur setelah transisi dari kondisi aktif ke kondisi menganggur. Untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan nilai

Tidak ada

Keterangan

Driver panggilan memasok perkiraan waktu residensi yang dapat digunakan PoFx sebagai petunjuk untuk meningkatkan performa. PoFx menggunakan petunjuk ini untuk memilih status Fx berdaya rendah yang sesuai untuk komponen yang berada dalam kondisi menganggur.

Driver perangkat dapat memanggil PoFxSetComponentResidency setiap kali perubahan keadaan memerlukan perubahan estimasi waktu residensi. Setelah setiap panggilan, perkiraan waktu residensi baru tetap berlaku sampai driver memanggil PoFxSetComponentResidency lagi untuk memperbaruinya.

Jika komponen berada dalam kondisi menganggur saat PoFxSetComponentResidency dipanggil, PoFx mungkin mengubah status Fx komponen untuk mengakomodasi perkiraan waktu residensi baru yang ditentukan oleh pemanggil.

Persyaratan

   
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.
Target Platform Universal
Header wdm.h
Pustaka Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL