struktur NDIS_PM_CAPABILITIES (ntddndis.h)
Struktur NDIS_PM_CAPABILITIES menentukan kemampuan manajemen daya adaptor jaringan.
Sintaks
typedef struct _NDIS_PM_CAPABILITIES {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
ULONG SupportedWoLPacketPatterns;
ULONG NumTotalWoLPatterns;
ULONG MaxWoLPatternSize;
ULONG MaxWoLPatternOffset;
ULONG MaxWoLPacketSaveBuffer;
ULONG SupportedProtocolOffloads;
ULONG NumArpOffloadIPv4Addresses;
ULONG NumNSOffloadIPv6Addresses;
NDIS_DEVICE_POWER_STATE MinMagicPacketWakeUp;
NDIS_DEVICE_POWER_STATE MinPatternWakeUp;
NDIS_DEVICE_POWER_STATE MinLinkChangeWakeUp;
ULONG SupportedWakeUpEvents;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_CAPABILITIES, *PNDIS_PM_CAPABILITIES;
Anggota
Header
Jenis, revisi, dan ukuran struktur NDIS_PM_CAPABILITIES . 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_CAPABILITIES , driver harus mengatur anggota RevisiHeader ke nilai berikut:
NDIS_PM_CAPABILITIES_REVISION_2
Menambahkan berbagai perubahan untuk NDIS 6.30.
Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2.
NDIS_PM_CAPABILITIES_REVISION_1
Versi asli untuk NDIS 6.20.
Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_1.
Flags
Nilai ULONG yang berisi bitwise OR dari bendera. Untuk NDIS 6.20, anggota ini dicadangkan untuk NDIS.
Dimulai dengan NDIS 6.30, bendera berikut ditentukan:
NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
Jika bendera ini diatur, adaptor jaringan harus dapat menyimpan paket yang diterima yang menyebabkan adaptor menghasilkan peristiwa bangun.
Jika bendera ini diatur, driver miniport harus dapat melakukan hal berikut dengan paket ini setelah adaptor jaringan beralih ke status daya penuh:
- Driver miniport harus dapat menunjukkan paket dengan memanggil NdisMIndicateReceiveNetBufferLists.
- Driver miniport harus dapat mengeluarkan indikasi status NDIS_STATUS_PM_WAKE_REASON dan harus melewati paket dengan indikasi.
NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
Jika bendera ini diatur, driver miniport mendukung penangguhan selektif NDIS untuk adaptor jaringan.
Untuk informasi selengkapnya tentang kemampuan manajemen daya ini, lihat Penangguhan Selektif NDIS.
SupportedWoLPacketPatterns
Nilai ULONG yang berisi bitwise ATAU bendera yang menentukan pola wake-on-LAN (WOL) yang didukung adaptor jaringan. Driver Miniport menggunakan bendera ini untuk mengiklankan pola WOL berbasis paket yang didukung adaptor jaringan.
Untuk informasi selengkapnya tentang anggota ini, lihat bagian Keterangan. Untuk informasi selengkapnya tentang pola WOL, lihat NDIS_PM_WOL_PATTERN.
NDIS_PM_WOL_BITMAP_PATTERN_SUPPORTED
Adaptor jaringan dapat menghasilkan peristiwa bangun saat menerima paket yang cocok dengan pola bitmap yang dikonfigurasi.
NDIS_PM_WOL_MAGIC_PACKET_SUPPORTED
Adaptor jaringan dapat menghasilkan peristiwa bangun ketika menerima paket ajaib WOL. Paket ajaib berisi dalam muatannya dengan string enam byte dengan nilai 0xFF, diikuti segera oleh 16 salinan berdekatan dari alamat Ethernet adaptor jaringan penerima.
NDIS_PM_WOL_IPV4_TCP_SYN_SUPPORTED
Adaptor jaringan dapat menghasilkan peristiwa bangun saat menerima paket IPv4 TCP SYN. Host jarak jauh mengirim paket TCP SYN untuk memulai koneksi TCP ke komputer lokal.
NDIS_PM_WOL_IPV6_TCP_SYN_SUPPORTED
Adaptor jaringan dapat menghasilkan peristiwa bangun saat menerima paket SYN TCP IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_SUPPORTED
Jika bendera ini diatur, adaptor jaringan mendukung 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.
Ketika adaptor jaringan mendukung IPv4 berdasarkan bangun pada pola paket LAN, seperti pola SYN TCP IPv4, adaptor jaringan harus mendukung pembuatan peristiwa bangun jika alamat IPv4 dan nilai port paket masuk cocok dengan yang ditentukan dalam pola bangun.
Namun, jika bendera NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_SUPPORTED diatur, adaptor jaringan juga dapat menghasilkan peristiwa bangun jika kondisi pencocokan pola berikut benar:
- Nilai apa pun dari paket masuk di lokasi yang ditentukan oleh pola WOL cocok, 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.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_SUPPORTED
Jika bendera ini diatur, adaptor jaringan mendukung 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.
Ketika adaptor jaringan mendukung IPv6 berdasarkan bangun pada pola paket LAN, seperti pola SYN TCP IPv6, adaptor harus mendukung pembuatan peristiwa bangun jika alamat IPv6 dan nilai port paket masuk cocok dengan yang ditentukan dalam pola bangun.
Namun, jika bendera NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_SUPPORTED diatur, adaptor jaringan juga dapat menghasilkan peristiwa bangun jika kondisi pencocokan pola berikut benar:
- Nilai apa pun dari paket masuk di lokasi yang ditentukan oleh pola WOL cocok, 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.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_SUPPORTED
Adaptor jaringan dapat menghasilkan peristiwa bangun saat menerima pesan pengidentifikasi permintaan EAPOL.
NumTotalWoLPatterns
Nilai ULONG yang berisi jumlah total pola WOL yang didukung adaptor jaringan. Ini adalah jumlah "jumlah pola protokol WOL yang didukung" dan "jumlah pola bitmap WOL yang didukung."
Misalnya, jika driver Anda mendukung 8 pola bitmap fleksibel, IPv4 TCP SYN (melalui filter prasetel), dan paket ajaib, maka Anda akan melaporkan 9 di NumTotalWoLPatterns. (8 bitmap + 1 IPv4 TCP SYN = 9)
MaxWoLPatternSize
Nilai ULONG yang berisi jumlah maksimum byte yang dapat dibandingkan dengan pola.
MaxWoLPatternOffset
Nilai ULONG yang berisi jumlah byte dalam paket yang dapat diperiksa, dimulai di awal header MAC.
MaxWoLPacketSaveBuffer
Nilai ULONG yang berisi jumlah byte paket WOL yang dapat disimpan driver miniport ke buffer dan menunjukkan tumpukan driver. Nilai ini harus kurang dari atau sama dengan ukuran, dalam byte, dari unit transmisi maksimum (MTU) untuk media jaringan. Driver melaporkan ukuran MTU melalui permintaan kueri OID OID_GEN_MAXIMUM_FRAME_SIZE.
SupportedProtocolOffloads
Nilai ULONG yang berisi bitwise ATAU bendera yang menentukan fitur offload protokol yang didukung adaptor jaringan. Driver miniport menggunakan bendera ini untuk melaporkan kemampuan offload protokol daya rendah adaptor jaringan.
NDIS_PM_PROTOCOL_OFFLOAD_ARP_SUPPORTED
Jika bit ini diatur, adaptor jaringan dapat merespons paket IPv4 ARP saat dalam status daya rendah
Untuk informasi selengkapnya tentang protokol ARP, lihat RFC 826.
NDIS_PM_PROTOCOL_OFFLOAD_NS_SUPPORTED
Jika bit ini diatur, adaptor jaringan dapat merespons paket IPv6 Neighbor Solicitation (NS) saat dalam keadaan daya rendah.
Untuk informasi selengkapnya tentang pesan IPv6 NS, lihat RFC 4861.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_SUPPORTED
Adaptor jaringan dapat merespons permintaan kunci ulang IEEE 802.11i Robust Security Network (RSN) saat berada dalam status daya rendah.
NumArpOffloadIPv4Addresses
Nilai ULONG yang berisi jumlah alamat IPv4 yang didukung adaptor untuk offload ARP.
NumNSOffloadIPv6Addresses
Nilai ULONG yang berisi jumlah permintaan offload IPv6 NS yang didukung adaptor. Ini harus setidaknya 2.
MinMagicPacketWakeUp
Menentukan status daya perangkat terendah dari mana adaptor jaringan dapat menandakan peristiwa bangun pada penerimaan paket ajaib. Paket ajaib berisi dalam muatannya dengan string enam byte dengan nilai 0xFF, diikuti segera oleh 16 salinan berdekatan dari alamat MAC adaptor jaringan penerima.
NdisDeviceStateUnspecified
Adaptor jaringan tidak mendukung bangun paket ajaib.
NdisDeviceStateD0
Adaptor jaringan dapat menandakan bangunnya paket ajaib dari status daya perangkat D0. Karena D0 adalah status yang sepenuhnya didukung, ini tidak menyebabkan bangun, tetapi dapat digunakan sebagai peristiwa run-time.
NdisDeviceStateD1
Adaptor jaringan dapat menandakan bangunnya paket ajaib dari status daya perangkat D1.
NdisDeviceStateD2
Adaptor jaringan dapat menandakan bangunnya paket ajaib dari status perangkat D2.
NdisDeviceStateD3
Adaptor jaringan dapat menandakan bangunnya paket ajaib dari status daya perangkat D3.
MinPatternWakeUp
Menentukan status daya perangkat terendah dari mana adaptor jaringan dapat menandakan peristiwa bangun pada penerimaan bingkai jaringan yang berisi pola yang ditentukan oleh driver protokol. Status daya ditentukan sebagai salah satu nilai NDIS_DEVICE_POWER_STATE berikut:
NdisDeviceStateUnspecified
Adaptor jaringan tidak mendukung bangun pencocokan pola.
NdisDeviceStateD0
Adaptor jaringan dapat menandakan bangunnya pencocokan pola dari status daya perangkat D0. Karena D0 adalah status yang sepenuhnya didukung, ini tidak menyebabkan bangun tetapi dapat digunakan sebagai peristiwa run-time.
NdisDeviceStateD1
Adaptor jaringan dapat menandakan bangunnya pencocokan pola dari status daya perangkat D1.
NdisDeviceStateD2
Adaptor jaringan dapat menandakan bangunnya pencocokan pola dari status daya perangkat D2.
NdisDeviceStateD3
Adaptor jaringan dapat menandakan bangunnya pencocokan pola dari status daya perangkat D3.
MinLinkChangeWakeUp
Dimulai dengan NDIS 6.20, anggota ini menentukan status daya perangkat terendah dari mana adaptor jaringan dapat memberi sinyal peristiwa bangun ketika status tautan berubah dari media yang terputus ke media yang terhubung.
Dimulai dengan NDIS 6.30, anggota ini menentukan status daya perangkat terendah dari mana adaptor jaringan dapat memberi sinyal peristiwa bangun. Peristiwa ini ditentukan dalam anggota SupportedWakeUpEvents .
Status daya ditentukan sebagai salah satu nilai NDIS_DEVICE_POWER_STATE berikut:
NdisDeviceStateUnspecified
Adapter jaringan tidak mendukung perubahan tautan bangun.
NdisDeviceStateD0
Adaptor jaringan dapat memberi sinyal bahwa tautan berubah bangun dari status daya perangkat D0. Karena D0 adalah status yang sepenuhnya didukung, ini tidak menyebabkan bangun tetapi dapat digunakan sebagai peristiwa run-time.
NdisDeviceStateD1
Adaptor jaringan dapat memberi sinyal bahwa tautan berubah bangun dari status daya perangkat D1.
NdisDeviceStateD2
Adaptor jaringan dapat memberi sinyal bahwa tautan berubah bangun dari status daya perangkat D2.
NdisDeviceStateD3
Adaptor jaringan dapat memberi sinyal bahwa tautan berubah bangun dari status daya perangkat D3.
SupportedWakeUpEvents
Nilai ULONG yang berisi bitwise OR dari bendera. Bendera ini menentukan peristiwa bangun independen media yang didukung adaptor jaringan. Peristiwa ini tidak spesifik untuk jenis media.
Dimulai dengan NDIS 6.30, bendera berikut ditentukan:
NDIS_PM_WAKE_ON_MEDIA_CONNECT_SUPPORTED
Jika bendera ini diatur, adaptor jaringan dapat menghasilkan peristiwa bangun saat tersambung ke antarmuka jaringan.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_SUPPORTED
Jika bendera ini diatur, adaptor jaringan dapat menghasilkan peristiwa bangun ketika terputus ke antarmuka jaringan.
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_SUPPORTED
Jika bendera ini diatur, adaptor jaringan 802.11 dapat menghasilkan peristiwa bangun jika mendeteksi pengidentifikasi set layanan (SSID) yang ditentukan melalui offload daftar jaringan (NLO).
Untuk informasi selengkapnya tentang NLO, lihat Offload Daftar Jaringan Wi-Fi.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_SUPPORTED
Jika bendera ini diatur, adaptor jaringan 802.11 dapat menghasilkan peristiwa bangun jika memisahkan dengan titik akses (AP).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_SUPPORTED
Jika bendera ini diatur, adaptor jaringan 802.11 dapat menghasilkan peristiwa bangun jika mengalami kesalahan selama jabat tangan kunci sementara (GTK) grup RSN IEEE 802.11i dengan AP.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_SUPPORTED
Jika bendera ini diatur, adaptor jaringan 802.11 dapat menghasilkan peristiwa bangun jika 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_SUPPORTED
Jika bendera ini diatur, adaptor jaringan broadband seluler (MB) dapat menghasilkan peristiwa bangun jika status pendaftarannya ke Layanan MB telah berubah.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_SUPPORTED
Jika bendera ini diatur, adaptor jaringan MB dapat menghasilkan peristiwa bangun jika 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_SUPPORTED
Jika bendera ini diatur, adaptor jaringan MB dapat menghasilkan peristiwa bangun jika menerima pesan Data Layanan Tambahan Tidak Terstruktur (USSD).
Keterangan
Struktur NDIS_PM_CAPABILITIES digunakan dalam anggota PowerManagementCapabilitiesEx NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES dan struktur NDIS_BIND_PARAMETERS dan dalam NDIS_STATUS_PM_CAPABILITIES_CHANGE indikasi status.
Selama inisialisasi miniport, driver miniport menginisialisasi struktur NDIS_PM_CAPABILITIES dengan kemampuan manajemen daya perangkat keras adaptor jaringan. Driver miniport kemudian mengatur anggota PowerManagementCapabilitiesEx dari struktur NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES untuk menunjuk ke struktur NDIS_PM_CAPABILITIES yang diinisialisasi.
Driver yang terlalu berlebihan tidak boleh mencoba mengaktifkan kapabilitas yang tidak didukung adaptor jaringan. Untuk memungkinkan driver yang terlalu berlebihan untuk menentukan kemampuan apa yang disediakan adaptor jaringan, NDIS menyediakan kemampuan dalam anggota PowerManagementCapabilitiesEx dari struktur NDIS_BIND_PARAMETERS.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Didukung di NDIS 6.20 dan yang lebih baru. |
| Header | ntddndis.h (termasuk Ntddndis.h) |
Lihat juga
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES NDIS_STATUS_PM_CAPABILITIES_CHANGESaran 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