Fungsi PoFxSetComponentLatency (wdm.h)

  • Artikel

Rutinitas PoFxSetComponentLatency menentukan latensi maksimum yang dapat ditoleransi dalam transisi dari kondisi diam ke kondisi aktif dalam komponen yang ditentukan.

Sintaks

void PoFxSetComponentLatency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Latency
);

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] Latency

Latensi maksimum, dalam unit 100 nanodetik, yang dapat ditoleransi dalam komponen yang ditentukan. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

Tidak ada

Keterangan

Driver panggilan menyediakan latensi maksimum yang dapat ditoleransi klien perangkat dalam komponen yang ditentukan. Latensi ini adalah waktu yang diperlukan untuk menyelesaikan transisi dari kondisi diam ke kondisi aktif. PoFx menggunakan latensi ini sebagai petunjuk untuk meningkatkan performa.

Ketika komponen beralih dari kondisi aktif ke kondisi diam, PoFx memilih status Fx berdaya rendah yang sesuai untuk dimasukkan komponen. Setelah transisi ini selesai, waktu yang diperlukan untuk beralih kembali ke kondisi aktif tergantung pada status Fx yang dipilih. PoFx mencoba memilih status Fx yang tidak melanggar persyaratan latensi maksimum.

Misalnya, jika driver mendukung status daya F0, F1, dan F2 dalam komponen yang ditentukan, status F2 mewakili pengaturan daya yang lebih rendah daripada status F1. Biasanya, waktu T2 yang diperlukan untuk bangun (ke status sepenuhnya pada, F0) dari F2 lebih lama dari waktu T1 yang diperlukan untuk bangun dari F1. Jika latensi maksimum lebih besar dari T1 tetapi kurang dari T2, PoFx dapat dengan aman mengalihkan komponen ke status F1 dan masih memenuhi persyaratan latensi maksimum. Namun, PoFx menghindari pengalihan komponen ke status F2 karena melakukannya melanggar persyaratan ini.

Driver perangkat dapat memanggil PoFxSetComponentLatency setiap kali perubahan kondisi memerlukan perubahan latensi maksimum. Setelah setiap panggilan, latensi maksimum baru tetap berlaku sampai driver memanggil PoFxSetComponentLatency lagi untuk memperbaruinya.

Jika komponen berada dalam kondisi menganggur saat PoFxSetComponentLatency dipanggil, PoFx mungkin mengubah status Fx komponen saat ini untuk mengakomodasi latensi maksimum 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

Lihat juga

PO_FX_DEVICE

PoFxRegisterDevice