共用方式為

報告電源管理功能

  • 發行項

支援 NDIS 6.20 和更新版本的迷你埠驅動程式會在初始化期間報告其硬體電源管理功能。 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 檔案設定的詳細資訊，請參閱 Power Management 的標準化 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 選擇性暫停。

支援的WoLPacketPatterns
包含旗標，指定網路適配器支援的網路喚醒 （WOL） 封包模式。 例如，網路適配器在收到位圖、WOL 魔術封包或透過 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 通訊協定模式位元元組數。

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

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

NumNSOffloadIPv6Addresses
包含網路適配器所支援的網路請求 (NS) 卸載 IPv6 要求數量。

MinMagicPacketWakeUp
指定網路適配器在收到 魔術封包後能夠發出喚醒事件訊號的最低的裝置電源狀態。 （魔術封包 是一個封包，其中包含接收網路適配器乙太網路位址的 16 個連續複本。

MinPatternWakeUp
指定網路適配器在收到包含通訊協定驅動程式所指定模式的網路框架時發出喚醒事件訊號的最低裝置電源狀態。

MinLinkChangeWakeUp
指定當有連結變更（媒體連線或中斷連線）時，網路適配器可以發出喚醒事件訊號的最低裝置電源狀態。

支援的喚醒事件
指定網路適配器支持的媒體獨立喚醒事件。 這些事件不是媒體類型特有的。 例如，這些喚醒事件包括連線變更事件。

MediaSpecificWakeUpEvents
指定網路配接器支援的媒體專屬喚醒事件。 例如，這些事件包括下列事項：

  • 802.11 網路適配器會解除與存取點 （AP） 的關聯。

  • 行動寬頻 （MB） 網路適配器會偵測其註冊狀態變更為 MB 服務。

如果迷你埠驅動程式支援將協定卸載至處於低功率狀態的網路介面卡，它必須支援匹配圖樣的WOL事件所需的相同低功率狀態的協定卸載。也就是說，在 MinPatternWakeUp 或 MinMagicPacketWakeUp 成員中指定的值。

NDIS 會使用基礎網路適配器目前可用的電源管理功能，初始化 NDIS_PM_CAPABILITIES 結構，並在系結操作期間將此結構傳遞給重疊的協定驅動程式。 NDIS 會將 PowerManagementCapabilitiesExNDIS_BIND_PARAMETERS 結構的成員設定為指向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 請求。