共用方式為


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 結構。

迷你埠驅動程序必須將 標頭Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。 若要指定 NDIS_PM_PARAMETERS 結構的版本,驅動程式必須將 Revision 成員 Header 設定為下列值:

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 旗標,這些旗標對應到 SupportedWoLPacketPatternsNDIS_PM_CAPABILITIES 結構成員中所報告之迷你埠驅動程式的功能。 NDIS 會使用這些旗標來啟用網路適配器用來從低電源狀態喚醒本機計算機的喚醒 (WOL) 模式。 如需 WOL 模式的詳細資訊,請參閱 NDIS_PM_WOL_PATTERN

使用下列旗標:

NDIS_PM_WOL_BITMAP_PATTERN_ENABLED

如果設定此旗標,網路適配器就會在收到符合已設定位圖模式的封包時產生喚醒事件。

NDIS_PM_WOL_MAGIC_PACKET_ENABLED

如果設定此旗標,網路適配器會在收到 WOL magic 封包時啟用以產生喚醒事件。 魔術封包 在其承載中包含 6 個字節且值為 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 埠的值。 如此一來,通配符值會比對WOL模式所指定位置中傳入封包的任何IPv4 位址和任何埠值。

如果設定此旗標,則如果下列模式比對條件成立,網路適配器就會產生喚醒事件:

  • 如果該位置的 WOL 模式包含通配符值,則來自 WOL 模式中傳入封包的任何值都是相符的。
  • 如果該位置的 WOL 模式包含等於封包值的非零值,則 WOL 模式中傳入封包的值會比對。

注意

 此旗標所啟用的通配符值可以包含未指定的 IPv4 來源和目的地位址,以及未指定的來源和目的地埠。

NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED

如果設定此旗標,網路適配器就必須將通配符 值視為任何填入零的值,或未指定的、WOL 模式中 IPv6 位址和 TCP/UDP 埠的值。 如此一來,通配符值就會比對WOL模式所指定位置中傳入封包的任何IPv6 位址和任何埠值。

如果設定此旗標,則如果下列模式比對條件成立,網路適配器就會產生喚醒事件:

  • 如果該位置的 WOL 模式包含通配符值,則來自 WOL 模式中傳入封包的任何值都是相符的。
  • 如果該位置的 WOL 模式包含等於封包值的非零值,則 WOL 模式中傳入封包的值會比對。

注意

 此旗標所啟用的通配符值可以包含未指定的 IPv6 來源和目的地位址,以及未指定的來源和目的地埠。

EnabledProtocolOffloads

ULONG 值,其中包含 NDIS_PM_CAPABILITIES 結構中 SupportedProtocolOffloads 成員中所報告之迷你埠驅動程式所報告功能的位 OR。 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 會使用這些旗標在網路適配器上啟用喚醒功能。 此成員會使用下列旗標:

如果已設定此旗標,當鏈接狀態從媒體中斷連線到已連線的媒體時,網路適配器會啟用以產生喚醒事件。

如需這項 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

ULONG 值,其中包含旗標的位 OR。 這些旗標會指定網路適配器支持的媒體特定喚醒事件。

從 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.11i RSN 4 向交握的 IEEE 802.11i RSN 4 向交握時產生喚醒事件。 此交握會在配接器向AP進行驗證時執行。

NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED

如果已設定此旗標,行動寬頻 (MB) 網路適配器會在註冊狀態變更 MB 服務時產生喚醒事件。

NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED

如果設定此旗標,MB 網路適配器就會啟用,以在 MB 服務必須收到簡短訊息服務 (SMS) 訊息的通知時產生喚醒事件。 配接器會在先前發出 OID_WWAN_SMS_READ 查詢要求完成之後,或從網路提供者傳回新類別 0 (flash/alert) 訊息作為事件通知之後,產生此喚醒事件。

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

如果設定此旗標,則會啟用 MB 網路適配器,以在插入、移除或進入錯誤狀態時產生喚醒事件。 此旗標是 Windows 10 的新功能。

言論

NDIS_PM_PARAMETERS 結構會指定 OID_PM_PARAMETERS OID 的已啟用電源管理硬體功能。 當查詢OID_PM_PARAMETERS OID 時,此結構會提供目前的電源管理設定。 設定 OID_PM_PARAMETERS OID 時,此結構會指定網路適配器應該使用的新電源管理組態。

過度配置驅動程式不應該嘗試啟用網路適配器不支援的功能。 若要讓過度配置驅動程式判斷網路適配器提供的功能,NDIS 提供 PowerManagementCapabilitiesExNDIS_BIND_PARAMETERS 結構成員中的功能。

注意

NDIS 6.20 和更新版本的驅動程序必須使用 PowerManagementCapabilitiesExNDIS_BIND_PARAMETERS 結構的成員,而不是 PowerManagementCapabilities 成員。

要求

要求 價值
最低支援的用戶端 NDIS 6.20 和更新版本支援。
標頭 ntddndis.h (包括 Ntddndis.h)

另請參閱

NDIS_BIND_PARAMETERS

NDIS_OBJECT_HEADER

NDIS_PM_CAPABILITIES

NDIS_PM_WOL_PATTERN

OID_GEN_CURRENT_PACKET_FILTER

OID_PM_PARAMETERS