共用方式為

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 會使用這些旗標在網路適配器上啟用喚醒功能。 此成員使用下列旗標：

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

如需此 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)

另請參閱

NDIS_BIND_PARAMETERS

NDIS_OBJECT_HEADER

NDIS_PM_CAPABILITIES

NDIS_PM_WOL_PATTERN

OID_GEN_CURRENT_PACKET_FILTER

OID_PM_PARAMETERS