Fungsi PoFxSetComponentResidency (wdm.h)
Rutinitas PoFxSetComponentResidency menetapkan perkiraan waktu untuk berapa lama komponen kemungkinan akan tetap menganggur setelah komponen memasuki kondisi diam.
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 ke PoFx tentang berapa lama komponen kemungkinan akan tetap menganggur setelah transisi dari kondisi aktif ke kondisi diam. Untuk informasi selengkapnya, lihat Keterangan.
Nilai kembali
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 dalam keadaan memerlukan perubahan perkiraan 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
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
Target Platform | Universal |
Header | wdm.h |
Pustaka | Ntoskrnl.lib |
DLL | Ntoskrnl.exe |
IRQL | <= DISPATCH_LEVEL |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk