NDIS_PM_PARAMETERS 結構 (ntddndis.h)
NDIS_PM_PARAMETERS 結構會指定為網路適配器啟用的目前或新的電源管理硬體功能。
語法
typedef struct _NDIS_PM_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG EnabledWoLPacketPatterns;
ULONG EnabledProtocolOffloads;
ULONG WakeUpFlags;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;
成員
Header
NDIS_PM_PARAMETERS 結構的型別、修訂和大小。 此成員的格式為 NDIS_OBJECT_HEADER 結構。
迷你埠驅動程序必須將 Header 的 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。 若要指定NDIS_PM_PARAMETERS結構的版本，驅動程式必須將 Header 的 Revision 成員設定為下列值：
NDIS_PM_PARAMETERS_REVISION_2
已新增 NDIS 6.30 的各種變更。
將 Size 成員設定為 NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2。
NDIS_PM_PARAMETERS_REVISION_1
NDIS 6.20 的原始版本。
將 Size 成員設定為 NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1。
EnabledWoLPacketPatterns
ULONG 值，其中包含一個位 OR 旗標，對應至NDIS_PM_CAPABILITIES 結構 SupportedWoLPacketPatterns 成員中所報告迷你埠驅動程式的功能。 NDIS 使用這些旗標來啟用網路喚醒 (WOL) 模式，網路適配器用來從低電源狀態喚醒本機電腦。 如需有關 WOL 模式的詳細資訊，請參閱 NDIS_PM_WOL_PATTERN。
使用下列旗標：
NDIS_PM_WOL_BITMAP_PATTERN_ENABLED
如果設定此旗標，網路適配器就會在收到符合已設定位圖模式的封包時產生喚醒事件。
NDIS_PM_WOL_MAGIC_PACKET_ENABLED
如果設定此旗標，網路適配器就會在收到WOL 魔術封包時產生喚醒事件。 魔術封包在其承載中包含值為 0xFF 的六個字節位元串，後面緊接著接收網路適配器的媒體訪問控制 (MAC) 位址的 16 個連續複本。
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
如果已設定此旗標，當網路適配器收到EAPOL要求標識符訊息時，就會啟用網路適配器來產生喚醒事件。
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
如果已設定此旗標，則網路適配器會在收到IPv4 TCP SYN 封包時啟用，以產生喚醒事件。 遠端主機會傳送 TCP SYN 封包，以起始本機電腦的 TCP 連線。
NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED
如果已設定此旗標，則網路適配器會在收到IPv6 TCP SYN 封包時啟用，以產生喚醒事件。
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
如果已設定此旗標，網路適配器就必須以WOL模式將IPv4位址和TCP/UDP埠的值視為任何填滿或未指定的通配符值。 如此一來，通配符值就會符合任何 IPv4 位址，以及由 WOL 模式所指定位置內送封包的任何埠值。
如果設定此旗標，如果下列模式比對條件成立，就會啟用網路適配器來產生喚醒事件：
- 如果該位置的 WOL 模式包含通配符值，來自 WOL 模式所指定位置內送封包的任何值都是相符的。
- 如果該位置的 WOL 模式包含等於封包值的非零值，則來自 WOL 模式中傳入封包的值是相符的。
注意
此旗標所啟用的通配符值可以包含未指定的 IPv4 來源和目的地位址，以及未指定的來源和目的地埠。
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED
如果已設定此旗標，網路適配器就必須以WOL模式將IPv6位址和TCP/UDP埠的值視為任何填滿或未指定的通配符值。 如此一來，通配符值就會符合任何 IPv6 位址，以及由 WOL 模式所指定位置內送封包的任何埠值。
如果設定此旗標，如果下列模式比對條件成立，就會啟用網路適配器來產生喚醒事件：
- 如果該位置的 WOL 模式包含通配符值，來自 WOL 模式所指定位置內送封包的任何值都是相符的。
- 如果該位置的 WOL 模式包含等於封包值的非零值，則來自 WOL 模式中傳入封包的值是相符的。
注意
此旗標所啟用的通配符值可以包含未指定的 IPv6 來源和目的地位址，以及未指定的來源和目的地埠。
EnabledProtocolOffloads
ULONG 值，其中包含一個位 OR 旗標，其對應至NDIS_PM_CAPABILITIES 結構的 SupportedProtocolOffloads 成員中所報告迷你埠驅動程式的功能。 NDIS 會使用這些旗標來啟用網路適配器上的低電源通訊協定卸除功能。 使用下列旗標：
NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED
如果設定此位，過度配置驅動程式會要求網路適配器啟用ARP通訊協定卸除功能。 一旦此通訊協定卸除是由 一組OID_PM_ADD_PROTOCOL_OFFLOAD所設定，驅動程式應該讓網路適配器在處於低電源狀態時回應 IPv4 ARP 封包。
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
如果設定此位，過度配置驅動程式會要求網路適配器啟用IPv6芳鄰要求 (NS) 通訊協定卸除功能。 一旦此通訊協定卸除是由 一組OID_PM_ADD_PROTOCOL_OFFLOAD所設定，驅動程式應該讓網路適配器在處於低電源狀態時回應 NS 封包。
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
如果設定此位，過度配置驅動程式會要求網路適配器啟用 IEEE 802.11i 強固安全性網路 (RSN) 通訊協定卸除功能。 一旦此通訊協定卸除是由 一組OID_PM_ADD_PROTOCOL_OFFLOAD所設定，驅動程式應該讓網路適配器在處於低電源狀態時回應 RSN 重新金鑰要求封包。
WakeUpFlags
ULONG 值，其中包含NDIS_PM_WAKE_ON_ Xxx 旗標的位 OR。 NDIS 會使用這些旗標在網路適配器上啟用喚醒功能。 此成員使用下列旗標：
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
如果已設定此旗標，當鏈接狀態從媒體中斷連線到已連線的媒體時，就會啟用網路適配器來產生喚醒事件。
如需此 WOL 功能的詳細資訊，請參閱 媒體中斷連線的低電源。
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED
如果已設定此旗標，當鏈接狀態從連線到媒體中斷連線的媒體變更時，就會啟用網路適配器來產生喚醒事件。
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
如果設定此旗標，每當發生下列其中一個事件時，就會啟用網路適配器來產生喚醒事件：
- 網路適配器會收到符合接收封包篩選的封包。 配接器會透過 OID_GEN_CURRENT_PACKET_FILTER的 OID 集合要求，使用這些篩選來設定。
- 網路適配器會偵測需要網路驅動程式堆疊處理的其他外部事件，例如當鏈接狀態變更為媒體中斷連線或媒體連線時。
注意
NDIS_PM_SELECTIVE_SUSPEND_ENABLED旗標可在 NDIS 6.30 和更新版本中使用。
如果已設定此旗標，就無法在 WakeUpFlags 成員中設定其他電源管理旗標， 而且 EnabledWoLPacketPatterns 成員必須設定為零。
如果 NDIS 設定 NDIS_PM_SELECTIVE_SUSPEND_ENABLED 旗標，它會將 OID_PM_PARAMETERS 的 OID 集合要求直接發出至迷你埠驅動程式。 這可讓 NDIS 略過網路驅動程式堆疊中的驅動程式來處理。
如需選擇性暫停電源管理功能的詳細資訊，請參閱 NDIS 選擇性暫停。
MediaSpecificWakeUpEvents
包含旗標位 OR 的 ULONG 值。 這些旗標會指定網路適配器支持的媒體特定喚醒事件。
從 NDIS 6.30 開始，定義下列旗標：
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
如果設定此旗標，則會啟用 802.11 網路適配器，以在偵測到透過網路卸除 (NLO) 指定的服務集標識碼 (SSID) 時產生喚醒事件。
如需 NLO 的詳細資訊，請參閱 Wi-Fi 網路清單卸除。
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
如果已設定此旗標，則會啟用 802.11 網路適配器，以在與存取點解除關聯 (AP) 時產生喚醒事件。
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
如果設定此旗標，則會啟用 802.11 網路適配器，以在 IEEE 802.11i RSN 群組暫時性密鑰期間發生錯誤時產生喚醒事件， (GTK) 與 AP 交握。
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
如果設定此旗標，則會啟用802.11網路適配器，以在收到IEEE 802.11iRSN 4向交握時產生喚醒事件。 此交握會在配接器向AP進行驗證時執行。
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
如果設定此旗標，當行動寬頻 (MB) 網路適配器變更時，就會產生喚醒事件。
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
如果已設定此旗標，當 MB 服務必須收到簡訊服務的接收通知時，會啟用 MB 網路適配器來產生喚醒事件， (SMS) 訊息。 配接器會在先前發出 OID_WWAN_SMS_READ 查詢要求之後產生此喚醒事件，或從網路提供者傳送新的類別 0 (快閃/警示) 訊息作為事件通知。
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
如果設定此旗標，MB 網路適配器就會在收到非結構化增補服務數據 (USSD) 訊息時產生喚醒事件。
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
如果設定此旗標，當行動數據封包數據的可用性變更時，會啟用 MB 網路適配器來產生喚醒事件。 此旗標是 Windows 10 的新功能。
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
如果設定此旗標，當 UICC) (SIM 卡插入、移除或進入錯誤狀態時，會啟用 MB 網路適配器來產生喚醒事件。 此旗標是 Windows 10 的新功能。
備註
NDIS_PM_PARAMETERS 結構會指定OID_PM_PARAMETERS OID 的已啟用電源管理功能。 當查詢OID_PM_PARAMETERS OID 時，此結構會提供目前的電源管理組態。 設定 OID_PM_PARAMETERS OID 時，此結構會指定網路適配器應該使用的新電源管理組態。
過度配置驅動程式不應該嘗試啟用網路適配器不支援的功能。 若要讓過度配置驅動程式判斷網路適配器所提供的功能，NDIS 提供NDIS_BIND_PARAMETERS結構的PowerManagementCapabilitiesEx成員中的功能。
注意
NDIS 6.20 和更新版本的驅動程序必須使用 NDIS_BIND_PARAMETERS 結構的PowerManagementCapabilitiesEx成員，而不是PowerManagementCapabilities成員。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.20 和更新版本支援。 |
| 標頭 | ntddndis.h (包含 Ntddndis.h) |