Kata Kunci INF Standar untuk Penangguhan Selektif NDIS
Catatan
Kata kunci terkait Suspensi Selektif hanya untuk penggunaan driver miniport NDIS tradisional. Mereka tidak digunakan lagi dalam Network Adapter WDF Class Extension (NetAdapterCx) dan tidak boleh digunakan oleh driver kliennya.
Kata kunci INF standar berikut didefinisikan untuk mengaktifkan, menonaktifkan, dan mengonfigurasi parameter untuk penangguhan selektif NDIS pada driver miniport:
*SelectiveSuspend Kata Kunci INF
*SSIdleTimeoutScreenOff Kata Kunci INF
Untuk informasi selengkapnya tentang kata kunci INF standar, lihat Kata Kunci INF Standar untuk Perangkat Jaringan.
*SelectiveSuspend INF Kata Kunci
File INF untuk driver miniport yang mendukung penangguhan selektif NDIS harus menentukan kata kunci INF standar *SelectiveSuspend . Setelah driver diinstal, administrator dapat memperbarui nilai kata kunci *SelectiveSuspend di halaman properti Tingkat Lanjut untuk adaptor jaringan. Untuk informasi selengkapnya tentang properti tingkat lanjut, lihat Menentukan Parameter Konfigurasi untuk Halaman Properti Tingkat Lanjut.
Catatan Driver miniport secara otomatis dimulai ulang setelah perubahan dilakukan di halaman properti Tingkat Lanjut untuk adaptor.
Kata kunci *SelectiveSuspend INF adalah kata kunci enumerasi. Tabel berikut ini menjelaskan kemungkinan entri INF untuk kata kunci *SelectiveSuspend INF. Kolom dalam tabel ini menjelaskan atribut berikut untuk kata kunci enumerasi:
SubkeyName
Nama kata kunci yang harus Anda tentukan dalam file INF. Nama ini juga muncul di registri di bawah kunci NDI\params\ untuk adaptor jaringan.
ParamDesc
Teks tampilan yang terkait dengan SubkeyName.
Catatan Vendor perangkat keras independen (IHV) dapat menentukan teks deskriptif apa pun untuk SubkeyName.
Nilai
Nilai bilangan bulat enumerasi yang terkait dengan setiap SubkeyName dalam daftar.
EnumDesc
Teks tampilan yang terkait dengan setiap nilai yang muncul di halaman properti Tingkat Lanjut .
| SubkeyName | ParamDesc | Nilai | EnumDesc |
|---|---|---|---|
*SelectiveSuspend |
Penangguhan selektif |
0 |
Nonaktif |
1 (Default) |
Aktif |
Driver miniport harus memeriksa nilai kata kunci *SelectiveSuspend di registri sebelum mengiklankan dukungannya untuk penangguhan selektif NDIS. Jika kata kunci *SelectiveSuspend memiliki nilai nol, miniport tidak boleh mengiklankan dukungan untuk kemampuan penangguhan selektif apa pun. Untuk informasi selengkapnya, lihat Melaporkan Kemampuan Penangguhan Selektif NDIS.
*Kata Kunci INF SSIdleTimeout
File INF untuk driver miniport yang mendukung penangguhan selektif NDIS harus menentukan kata kunci INF standar *SSIdleTimeout opsional. Kata kunci ini menentukan periode batas waktu diam dalam satuan detik. Jika NDIS tidak mendeteksi aktivitas apa pun pada adaptor jaringan untuk periode yang melebihi nilai *SSIdleTimeout , NDIS memulai operasi penangguhan selektif dengan memanggil fungsi handler MiniportIdleNotification driver miniport.
Setelah driver diinstal, administrator dapat memperbarui nilai kata kunci *SSIdleTimeout di halaman properti Tingkat Lanjut untuk adaptor jaringan. Untuk informasi selengkapnya tentang properti tingkat lanjut, lihat Menentukan Parameter Konfigurasi untuk Halaman Properti Tingkat Lanjut.
Catatan Driver miniport secara otomatis dimulai ulang setelah perubahan dilakukan di halaman properti tingkat lanjut untuk adaptor.
Kata kunci INF *SSIdleTimeout adalah kata kunci numerik (Int). Tabel berikut ini menjelaskan kemungkinan entri INF untuk kata kunci INF *SSIdleTimeout . Kolom dalam tabel menjelaskan atribut berikut untuk kata kunci Int :
SubkeyName
Nama kata kunci yang harus Anda tentukan dalam file INF. Nama ini juga muncul di registri di bawah kunci NDI\params\ untuk adaptor jaringan.
ParamDesc
Teks tampilan yang terkait dengan SubkeyName.
Catatan Vendor perangkat keras independen (IHV) dapat menentukan teks deskriptif apa pun untuk SubkeyName.
Nilai default
Nilai default untuk bilangan bulat.
Nilai minimum
Nilai minimum yang diizinkan untuk bilangan bulat.
Nilai maksimum
Nilai maksimum yang diizinkan untuk bilangan bulat.
| SubkeyName | ParamDesc | Nilai default | Nilai minimum | Nilai maksimum |
|---|---|---|---|---|
*SSIdleTimeout |
Selektif menangguhkan batas waktu diam dalam satuan detik |
5 |
1 |
60 |
Catatan NDIS membaca nilai kata kunci INF standar *SSIdleTimeout untuk setiap instans adaptor jaringan yang drivernya mendukung penangguhan selektif NDIS. Driver Miniport tidak boleh membaca kata kunci ini.
NDIS mengukur batas waktu diam dengan menggunakan timer yang tepat untuk dalam 30 persen dari nilai *SSIdleTimeout . Misalnya, jika nilai *SSIdleTimeout adalah 10, adaptor ditangguhkan antara 10 hingga 13 detik setelah NDIS terlebih dahulu mendeteksi adaptor menganggur.
*Kata Kunci INF SSIdleTimeoutScreenOff
File INF untuk driver miniport yang mendukung penangguhan selektif NDIS harus menentukan kata kunci INF standar *SSIdleTimeoutScreenOff opsional. Kata kunci ini menentukan periode batas waktu diam dalam satuan detik dan hanya berlaku saat layar nonaktif. Jika NDIS tidak mendeteksi aktivitas apa pun pada adaptor jaringan untuk periode yang melebihi nilai *SSIdleTimeoutScreenOff setelah layar nonaktif, NDIS memulai operasi penangguhan selektif dengan memanggil fungsi handler MiniportIdleNotification driver miniport.
Setelah driver diinstal, administrator dapat memperbarui nilai kata kunci *SSIdleTimeoutScreenOff di halaman properti Tingkat Lanjut untuk adaptor jaringan. Untuk informasi selengkapnya tentang properti tingkat lanjut, lihat Menentukan Parameter Konfigurasi untuk Halaman Properti Tingkat Lanjut.
Catatan Driver miniport secara otomatis dimulai ulang setelah perubahan dilakukan di halaman properti tingkat lanjut untuk adaptor.
Kata kunci *SSIdleTimeoutScreenOff INF adalah kata kunci numerik (Int). Tabel berikut ini menjelaskan kemungkinan entri INF untuk kata kunci *SSIdleTimeoutScreenOff INF. Kolom dalam tabel menjelaskan atribut berikut untuk kata kunci Int :
SubkeyName
Nama kata kunci yang harus Anda tentukan dalam file INF. Nama ini juga muncul di registri di bawah kunci NDI\params\ untuk adaptor jaringan.
ParamDesc
Teks tampilan yang terkait dengan SubkeyName.
Catatan Vendor perangkat keras independen (IHV) dapat menentukan teks deskriptif apa pun untuk SubkeyName.
Nilai default
Nilai default untuk bilangan bulat.
Nilai minimum
Nilai minimum yang diizinkan untuk bilangan bulat.
Nilai maksimum
Nilai maksimum yang diizinkan untuk bilangan bulat.
| SubkeyName | ParamDesc | Nilai default | Nilai minimum | Nilai maksimum |
|---|---|---|---|---|
*SSIdleTimeoutScreenOff |
Selektif menangguhkan waktu diam habis dalam satuan detik |
3 |
1 |
60 |
Catatan NDIS membaca nilai kata kunci INF standar *SSIdleTimeoutScreenOff untuk setiap instans adaptor jaringan yang drivernya mendukung penangguhan selektif NDIS. Driver miniport tidak boleh membaca kata kunci ini.
Catatan Nilai maksimum hanya untuk tujuan pengujian. Uji sertifikasi HLK akan secara eksplisit memeriksa dan gagal jika nilainya lebih dari 5.
NDIS mengukur batas waktu diam dengan menggunakan timer yang tepat untuk dalam 30 persen dari nilai *SSIdleTimeoutScreenOff . Misalnya, jika nilai *SSIdleTimeoutScreenOff adalah 5, adaptor ditangguhkan antara 5 hingga 6,5 detik setelah NDIS mendeteksi adaptor diam terlebih dahulu.
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk