共用方式為

報告電源管理功能

  • 發行項

支援 NDIS 6.20 和更新版本 NDIS 的迷你埠驅動程式會在初始化期間回報其硬體電源管理功能。 NDIS 會在系結作業期間將目前的功能報告至過度運作的 NDIS 通訊協定驅動程式。 不過，NDIS 可以從通訊協定驅動程式隱藏某些功能。 例如，當使用者停用部分或所有電源管理功能時，NDIS 可能會報告不同的功能。

請注意，NDIS 回報給通訊協定驅動程式的目前電源管理功能不一定與迷你埠驅動程式回報給 NDIS 的硬體功能相同。

如果 NDIS 6.1 或更早版本的迷你埠驅動程式系結至 NDIS 6.20 通訊協定驅動程式，NDIS 會將電源管理功能轉譯為 NDIS 6.20 通訊協定驅動程式所支援的格式。 NDIS 也會將 NDIS 6.20 迷你埠驅動程式所報告的電源管理功能轉譯成 NDIS 6.1 和更早版本超載驅動程式所支援的格式。

迷你埠驅動程式報告的硬體功能可以在 INF 檔案設定中啟用或停用。 如需電源管理 INF 檔案設定的詳細資訊，請參閱 電源管理的標準化 INF 關鍵字。

在迷你埠初始化期間，迷你埠驅動程式會使用基礎硬體的電源管理功能，初始化 NDIS_PM_CAPABILITIES 結構。 迷你埠驅動程式會將NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES結構的PowerManagementCapabilitiesEx成員設定為指向NDIS_PM_CAPABILITIES結構。

NDIS_PM_CAPABILITIES結構包含下列資訊：

旗標
針對 NDIS 6.20，此成員會保留給 NDIS。

從 NDIS 6.30 開始，會定義下列旗標：

NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
如果設定此旗標，網路介面卡可以儲存導致配接器產生喚醒事件的接收封包。

如需此電源管理功能的詳細資訊，請參閱 NDIS 喚醒原因狀態指示。

NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
如果設定此旗標，迷你埠驅動程式支援網路介面卡的 NDIS 選擇性暫停。

如需此電源管理功能的詳細資訊，請參閱 NDIS 選擇性暫停。

SupportedWoLPacketPatterns
包含旗標，指定網路介面卡支援的網路喚醒 (WOL) 封包模式。 例如，網路介面卡可以在收到點陣圖、WOL magic 封包或透過 LAN 的 EAP (EAPOL) 要求識別碼訊息時產生喚醒事件。 如需目前作業系統所支援模式的完整清單，請參閱 NDIS_PM_CAPABILITIES 參考頁面。

NumTotalWoLPatterns
ULONG值，其中包含網路介面卡支援的 WOL 模式總數。 這是「支援的 WOL 通訊協定模式數目」和「支援的 WOL 點陣圖模式數目」的總和。

例如，如果您的驅動程式支援 8 個彈性點陣圖模式，IPv4 TCP SYN (透過預設篩選) 和 magic 封包，則您會在 NumTotalWoLPatterns 中回報 9。 (8 個位圖 + 1 個 IPv4 TCP SYN = 9)

注意 WOL 模式的總數不包含魔術封包喚醒模式。

如需 WOL 通訊協定模式的詳細資訊，請參閱 NDIS_PM_WOL_PATTERN。

MaxWoLPatternSize
包含可以與模式比較的最大位元組數目。

MaxWoLPatternOffset
包含封包中可以檢查的位元組數目，從 MAC 標頭的開頭開始。

MaxWoLPacketSaveBuffer
包含 Miniport 驅動程式可以儲存至緩衝區並指出驅動程式堆疊的 WOL 通訊協定模式位元組數。

SupportedProtocolOffloads
包含旗標，指定網路介面卡支援的電源管理通訊協定卸載功能。 迷你埠驅動程式會使用這些旗標來報告網路介面卡的低電源通訊協定卸載功能。 例如，網路介面卡可以支援 IPv4 ARP 卸載、IPv6 芳鄰請求 (NS) ，或 IEEE 802.11 強固的安全網路 (RSN) 4 向和雙向交握。 如需目前作業系統所支援之通訊協定卸載的完整清單，請參閱 NDIS_PM_CAPABILITIES 參考頁面。

NumArpOffloadIPv4Addresses
包含 ARP 卸載 IPv4 位址的數目。

NumNSOffloadIPv6Addresses
包含網路介面卡支援的 IPv6 要求數目， (NS) 卸載 IPv6 要求。

MinMagicPacketWakeUp
指定網路介面卡在收到 魔術封包時發出喚醒事件的訊號的最低裝置電源狀態。 (magic 封包 是一個封包，其中包含接收網路介面卡乙太網路位址的 16 個連續複本。)

MinPatternWakeUp
指定網路介面卡可以在收到網路框架時發出喚醒事件的最低裝置電源狀態，其中包含通訊協定驅動程式所指定的模式。

MinLinkChangeWakeUp
指定網路介面卡在媒體連線或中斷連線 () 發生連結變更時，網路介面卡可以發出喚醒事件訊號的最低裝置電源狀態。

SupportedWakeUpEvents
指定網路介面卡支援的媒體獨立喚醒事件。 這些事件不是媒體類型特有的。 例如，這些喚醒事件包括連結變更事件。

MediaSpecificWakeUpEvents
指定網路介面卡支援的媒體特定喚醒事件。 例如，這些事件包括下列各項：

  • 802.11 網路介面卡會解除與存取點 (AP) 的關聯。

  • 行動寬頻 (MB) 網路介面卡會偵測其註冊狀態變更為 MB 服務。

如果迷你埠驅動程式支援將通訊協定卸載至處於低電源狀態的網路介面卡，它必須針對支援模式比對 WOL 事件的通訊協定卸載支援相同的低電源狀態;也就是說， MinPatternWakeUp 或 MinMagicPacketWakeUp 成員中指定的值。

NDIS 會使用基礎網路介面卡目前可用的電源管理功能，初始化 NDIS_PM_CAPABILITIES 結構，並在系結作業期間將通訊協定過度傳遞至通訊協定驅動程式。 NDIS 會將NDIS_BIND_PARAMETERS結構的PowerManagementCapabilitiesEx成員設定為指向NDIS_PM_CAPABILITIES結構。

過度運用驅動程式可以使用 OID_PM_HARDWARE_CAPABILITIES OID 查詢來取得網路介面卡的硬體電源管理功能。 NDIS 會代表迷你埠驅動程式處理此 OID 要求。 NDIS 迷你埠驅動程式不需要支援 OID_PM_HARDWARE_CAPABILITIES OID 要求。

過度配置驅動程式可以使用 OID_PM_CURRENT_CAPABILITIES OID 來查詢網路介面卡目前可用的電源管理功能。 NDIS 會代表迷你埠驅動程式處理此 OID 要求。 NDIS 迷你埠驅動程式不需要支援 OID_PM_CURRENT_CAPABILITIES OID 要求。