struktur NDIS_PM_PARAMETERS (ntddndis.h)
Struktur NDIS_PM_PARAMETERS menentukan kemampuan perangkat keras manajemen daya saat ini atau baru yang diaktifkan untuk adaptor jaringan.
Sintaks
typedef struct _NDIS_PM_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG EnabledWoLPacketPatterns;
ULONG EnabledProtocolOffloads;
ULONG WakeUpFlags;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;
Anggota
Header
Jenis, revisi, dan ukuran struktur NDIS_PM_PARAMETERS . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .
Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_PM_PARAMETERS , driver harus mengatur anggota RevisiHeader ke nilai berikut:
NDIS_PM_PARAMETERS_REVISION_2
Menambahkan berbagai perubahan untuk NDIS 6.30.
Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2.
NDIS_PM_PARAMETERS_REVISION_1
Versi asli untuk NDIS 6.20.
Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1.
EnabledWoLPacketPatterns
Nilai ULONG yang berisi bitwise ATAU bendera yang sesuai dengan kemampuan yang dilaporkan driver miniport di anggota SupportedWoLPacketPatterns dari struktur NDIS_PM_CAPABILITIES . NDIS menggunakan bendera ini untuk mengaktifkan pola wake-on-LAN (WOL) yang digunakan adaptor jaringan untuk membangunkan komputer lokal dari status daya rendah. Untuk informasi selengkapnya tentang pola WOL, lihat NDIS_PM_WOL_PATTERN.
Bendera berikut digunakan:
NDIS_PM_WOL_BITMAP_PATTERN_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun saat menerima paket yang cocok dengan pola bitmap yang dikonfigurasi.
NDIS_PM_WOL_MAGIC_PACKET_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun saat menerima paket ajaib WOL. Paket ajaib berisi dalam muatannya dengan string enam byte dengan nilai 0xFF, diikuti segera oleh 16 salinan berdekatan dari alamat kontrol akses media (MAC) adaptor jaringan penerima.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun saat menerima pesan pengidentifikasi permintaan EAPOL.
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun saat menerima paket SYN IPv4 TCP. Host jarak jauh mengirim paket TCP SYN untuk memulai koneksi TCP ke komputer lokal.
NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun saat menerima paket SYN TCP IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Jika bendera ini diatur, adaptor jaringan harus diperlakukan sebagai nilai kartubebas yang diisi nol, atau tidak ditentukan, nilai untuk alamat IPv4 dan port TCP/UDP dalam pola WOL. Dengan cara ini, nilai kartubebas cocok dengan alamat IPv4 dan nilai port apa pun dari paket masuk di lokasi yang ditentukan oleh pola WOL.
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun jika kondisi pencocokan pola berikut ini benar:
- Nilai apa pun dari paket masuk di lokasi yang ditentukan oleh pola WOL adalah kecocokan, jika pola WOL untuk lokasi tersebut berisi nilai kartubebas.
- Nilai dari paket masuk di lokasi yang ditentukan oleh pola WOL cocok jika pola WOL untuk lokasi tersebut berisi nilai bukan nol yang sama dengan nilai paket.
Catatan
Nilai kartubebas yang diaktifkan oleh bendera ini dapat mencakup alamat sumber dan tujuan IPv4 yang tidak ditentukan, serta port sumber dan tujuan yang tidak ditentukan.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED
Jika bendera ini diatur, adaptor jaringan harus diperlakukan sebagai nilai kartubebas yang diisi nol, atau tidak ditentukan, nilai untuk alamat IPv6 dan port TCP/UDP dalam pola WOL. Dengan cara ini, nilai kartubebas cocok dengan alamat IPv6 dan nilai port apa pun dari paket masuk di lokasi yang ditentukan oleh pola WOL.
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun jika kondisi pencocokan pola berikut ini benar:
- Nilai apa pun dari paket masuk di lokasi yang ditentukan oleh pola WOL adalah kecocokan, jika pola WOL untuk lokasi tersebut berisi nilai kartubebas.
- Nilai dari paket masuk di lokasi yang ditentukan oleh pola WOL cocok jika pola WOL untuk lokasi tersebut berisi nilai bukan nol yang sama dengan nilai paket.
Catatan
Nilai kartubebas yang diaktifkan oleh bendera ini dapat mencakup alamat sumber dan tujuan IPv6 yang tidak ditentukan, serta port sumber dan tujuan yang tidak ditentukan.
EnabledProtocolOffloads
Nilai ULONG yang berisi bitwise ATAU bendera yang sesuai dengan kemampuan yang dilaporkan driver miniport di anggota SupportedProtocolOffloads dari struktur NDIS_PM_CAPABILITIES . NDIS menggunakan bendera ini untuk mengaktifkan kemampuan offload protokol daya rendah pada adaptor jaringan. Bendera berikut digunakan:
NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED
Jika bit ini diatur, driver yang terlalu berlebihan akan meminta adaptor jaringan untuk mengaktifkan kemampuan offload protokol ARP. Segera setelah offload protokol ini telah dikonfigurasi oleh permintaan set OID_PM_ADD_PROTOCOL_OFFLOAD, driver harus mengaktifkan adaptor jaringan untuk merespons paket IPv4 ARP saat berada dalam status daya rendah.
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
Jika bit ini diatur, driver yang terlalu berlebihan akan meminta adaptor jaringan untuk mengaktifkan kemampuan offload protokol IPv6 Neighbor Solicitation (NS). Segera setelah offload protokol ini telah dikonfigurasi oleh permintaan set OID_PM_ADD_PROTOCOL_OFFLOAD, driver harus mengaktifkan adaptor jaringan untuk merespons paket NS saat berada dalam status daya rendah.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
Jika bit ini diatur, driver yang terlalu berlebihan akan meminta adaptor jaringan untuk mengaktifkan kemampuan offload protokol IEEE 802.11i Robust Security Network (RSN). Segera setelah offload protokol ini telah dikonfigurasi oleh permintaan set OID_PM_ADD_PROTOCOL_OFFLOAD, driver harus mengaktifkan adaptor jaringan untuk menanggapi paket permintaan kunci ulang RSN saat berada dalam status daya rendah.
WakeUpFlags
Nilai ULONG yang berisi bitwise OR dari bendera Xxx NDIS_PM_WAKE_ON_. NDIS menggunakan bendera ini untuk mengaktifkan kemampuan bangun pada adaptor jaringan. Anggota ini menggunakan bendera berikut:
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun ketika status tautan berubah dari media yang terputus ke media yang tersambung.
Untuk informasi selengkapnya tentang kapabilitas WOL ini, lihat Pemutusan Daya Rendah pada Media.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun ketika status tautan berubah dari media yang terhubung ke media terputus.
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
Jika bendera ini diatur, adaptor jaringan diaktifkan untuk menghasilkan peristiwa bangun setiap kali salah satu peristiwa berikut terjadi:
- Adaptor jaringan menerima paket yang cocok dengan filter paket penerima. Adaptor dikonfigurasi dengan filter ini melalui permintaan set OID_GEN_CURRENT_PACKET_FILTER OID.
- Adaptor jaringan mendeteksi peristiwa eksternal lain yang memerlukan pemrosesan oleh tumpukan driver jaringan, seperti ketika status tautan berubah menjadi pemutusan sambungan media atau media yang tersambung.
Catatan
Bendera NDIS_PM_SELECTIVE_SUSPEND_ENABLED tersedia di NDIS 6.30 dan yang lebih baru.
Jika bendera ini diatur, tidak ada bendera manajemen daya lain yang dapat diatur di anggota WakeUpFlags dan anggota EnabledWoLPacketPatterns harus diatur ke nol.
Jika NDIS menetapkan bendera NDIS_PM_SELECTIVE_SUSPEND_ENABLED , NDIS mengeluarkan permintaan set OID OID_PM_PARAMETERS langsung ke driver miniport. Ini memungkinkan NDIS untuk melewati pemrosesan oleh driver filter di tumpukan driver jaringan.
Untuk informasi selengkapnya tentang kemampuan manajemen daya yang ditangguhkan selektif, lihat Penangguhan Selektif NDIS.
MediaSpecificWakeUpEvents
Nilai ULONG yang berisi bitwise OR dari bendera. Bendera ini menentukan peristiwa bangun khusus media yang didukung adaptor jaringan.
Dimulai dengan NDIS 6.30, bendera berikut ditentukan:
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
Jika bendera ini diatur, adaptor jaringan 802.11 diaktifkan untuk menghasilkan peristiwa bangun saat mendeteksi pengidentifikasi set layanan (SSID) yang ditentukan melalui offload jaringan (NLO).
Untuk informasi selengkapnya tentang NLO, lihat Offload Daftar Jaringan Wi-Fi.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Jika bendera ini diatur, adaptor jaringan 802.11 diaktifkan untuk menghasilkan peristiwa bangun saat memisahkan dengan titik akses (AP).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Jika bendera ini diatur, adaptor jaringan 802.11 diaktifkan untuk menghasilkan peristiwa bangun ketika mengalami kesalahan selama jabat tangan kunci sementara (GTK) grup RSN IEEE 802.11i dengan AP.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Jika bendera ini diatur, adaptor jaringan 802.11 diaktifkan untuk menghasilkan peristiwa bangun saat menerima bingkai pertama jabat tangan IEEE 802.11i RSN 4-way dengan AP. Jabat tangan ini dilakukan ketika adaptor mengautentikasi dengan AP.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
Jika bendera ini diatur, adaptor jaringan broadband seluler (MB) diaktifkan untuk menghasilkan peristiwa bangun ketika status pendaftarannya ke Layanan MB telah berubah.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
Jika bendera ini diatur, adaptor jaringan MB diaktifkan untuk menghasilkan peristiwa bangun ketika Layanan MB harus diberi tahu tentang penerimaan pesan Layanan Pesan Singkat (SMS). Adaptor menghasilkan peristiwa bangun ini baik setelah penyelesaian permintaan kueri OID_WWAN_SMS_READ yang dikeluarkan sebelumnya, atau kedatangan pesan kelas-0 baru (flash/alert) dari penyedia jaringan sebagai pemberitahuan peristiwa.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
Jika bendera ini diatur, adaptor jaringan MB diaktifkan untuk menghasilkan peristiwa bangun saat menerima pesan Data Layanan Tambahan Tidak Terstruktur (USSD).
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
Jika bendera ini diatur, adaptor jaringan MB diaktifkan untuk menghasilkan peristiwa bangun saat ketersediaan data paket seluler berubah. Bendera ini baru dalam Windows 10.
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
Jika bendera ini diatur, adaptor jaringan MB diaktifkan untuk menghasilkan peristiwa bangun saat kartu UICC (SIM) dimasukkan, dihapus, atau memasuki status kesalahan. Bendera ini baru dalam Windows 10.
Keterangan
Struktur NDIS_PM_PARAMETERS menentukan kemampuan perangkat keras manajemen daya yang diaktifkan untuk OID_PM_PARAMETERS OID. Ketika OID OID_PM_PARAMETERS dikueri, struktur ini menyediakan konfigurasi manajemen daya saat ini. Ketika OID_PM_PARAMETERS OID diatur, struktur ini menentukan konfigurasi manajemen daya baru yang harus digunakan adaptor jaringan.
Driver yang terlalu berlebihan tidak boleh mencoba mengaktifkan kapabilitas yang tidak didukung adaptor jaringan. Untuk mengaktifkan driver yang terlalu berlebihan untuk menentukan kemampuan apa yang disediakan adaptor jaringan, NDIS menyediakan kemampuan dalam anggota PowerManagementCapabilitiesEx dari struktur NDIS_BIND_PARAMETERS .
Catatan
Driver NDIS 6.20 dan yang lebih baru harus menggunakan anggota PowerManagementCapabilitiesEx dari struktur NDIS_BIND_PARAMETERS alih-alih anggota PowerManagementCapabilities .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Didukung di NDIS 6.20 dan yang lebih baru. |
| Header | ntddndis.h (termasuk Ntddndis.h) |
Lihat juga
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