新增和刪除網路喚醒模式

若要新增網路喚醒 (WOL) 模式，NDIS 通訊協定驅動程式會發出 OID 集合 要求OID_PM_ADD_WOL_PATTERN。 NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_PM_WOL_PATTERN結構的指標。 如果網路介面卡支援該 WOL 封包，通訊協定驅動程式應該指定 WOL 封包。 當網路介面卡不支援 WOL 封包時，通訊協定驅動程式應該使用 WOL 點陣圖喚醒方法。

NDIS_PM_WOL_PATTERN包含下列資訊：

優先
包含 WOL 模式的優先順序。 如果過度使用驅動程式在沒有資源可供更多 WOL 模式使用時，會增加優先順序較高的 WOL 模式，NDIS 可能會移除較低優先順序的 WOL 模式以釋出資源。 迷你埠驅動程式應該忽略此成員。 通訊協定驅動程式可以指定預先定義範圍中的任何優先順序，從NDIS_PM_WOL_PRIORITY_LOWEST到NDIS_PM_WOL_PRIORITY_HIGHEST。

WoLPacketType
包含指定 WOL 封包類型的 NDIS_PM_WOL_PACKET 列舉值。

FriendlyName
包含 NDIS_PM_COUNTED_STRING 結構，其中包含 WOL 封包的使用者可讀取描述。

PatternId
包含識別 WOL 模式的 NDIS 提供值。 在 NDIS 將 OID_PM_ADD_WOL_PATTERN OID 要求向下傳送至基礎 NDIS 驅動程式或完成對過度配置驅動程式的要求之前，NDIS 會將 PatternId 設定為網路介面卡上的 WOL 模式中唯一的值。

NextWoLPatternOffset
(包含從 OID 要求 InformationBuffer 開頭到OID_PM_WOL_PATTERN_LIST OID 清單中下NDIS_PM_WOL_PATTERN一個NDIS_PM_WOL_PATTERN結構的 OID 要求InformationBuffer) 位移NDIS_PM_WOL_PATTERN。 如需OID_PM_WOL_PATTERN_LIST的詳細資訊，請參閱 取得 WOL 模式的目前設定。

WoLPattern
包含其中一個 IPv4TcpSynParameters、 IPv6TcpSynParameters、 EapolRequestIdMessageParameters或 Union 中的 WoLBitMapPattern 結構。

IPv4TcpSynParameters
包含 IPv4 TCP 同步處理 (SYN) 資訊。

IPv6TcpSynParameters
包含 IPv6 TCP SYN 資訊。

EapolRequestIdMessageParameters
包含透過 LAN 的 802.1X EAP (EAPOL) 要求身分識別訊息參數。

WoLBitMapPattern
包含 WOL 點陣圖模式規格。

NDIS 會將網路介面卡唯一的識別碼指派給每個 WOL 模式。 模式識別碼是網路介面卡上設定的每個模式的唯一值。 不過，在所有網路介面卡上，模式識別碼並非全域唯一的。 當 NDIS 將 OID_PM_ADD_WOL_PATTERN OID 要求傳送至迷你埠驅動程式時，NDIS 會將識別碼傳遞至基礎網路介面卡。 如果新增 WOL 模式成功，NDIS 會將識別碼傳回至新增 WOL 模式的過度驅動程式。 過度處理驅動程式會使用識別碼來移除先前新增的 WOL 模式。 當將 WOL 模式從網路介面卡移除時，模式識別碼也會用於過度配置驅動程式的狀態指示。

通訊協定驅動程式必須發出 OID_PM_REMOVE_WOL_PATTERN 的 OID 集合要求，以移除新增至網路介面卡的所有模式，再關閉該網路介面卡的系結。 NDIS_OID_REQUEST結構的InformationBuffer成員包含模式識別碼的指標。

使用者模式應用程式會使用 GUID_PM_REMOVE_WOL_PATTERN WMI GUID，從網路介面卡移除先前新增的 WOL 模式。 NDIS 會將此 WMI 要求轉譯為網路介面卡 OID_PM_REMOVE_WOL_PATTERN 的 OID 集合要求。 NDIS 會先刪除應用程式從網路介面卡新增的所有 WOL 模式，再停止網路介面卡。

NDIS 可讓多個 NDIS 通訊協定驅動程式將 WOL 模式新增至相同的網路介面卡。 為了確保在要求的 WOL 模式數目高於網路介面卡可支援的數量時，已設定正確的一組 WOL 模式，通訊協定驅動程式會在NDIS_PM_WOL_PATTERN結構的 Priority 成員中，為每個要求的 WOL 模式指派優先順序。 當 NDIS 因為網路介面卡資源不足而無法新增高優先順序的 WOL 模式時，如果有任何) 並嘗試再次新增高優先順序模式，則 NDIS 會刪除其中一個較低的優先順序模式 (。

注意 迷你埠驅動程式應該會失敗模式新增要求，並傳回STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL狀態碼，以允許 NDIS 重新設定模式的優先順序。

如果 NDIS 刪除其中一個優先順序較低的模式，它會通知過度使用NDIS_STATUS_PM_WOL_PATTERN_REJECTED狀態指示來設定已刪除模式 的 驅動程式。 NDIS_STATUS_INDICATION結構的StatusBuffer成員包含已拒絕之 WOL 模式識別碼的 ULONG。 NDIS 在NDIS_PM_WOL_PATTERN結構的PatternId成員中提供了 WOL 模式識別碼。

若為無線網路介面卡，其可能會使用基礎結構元素在跨基礎結構漫遊時卸載模式，新的基礎結構元素可能不支援相同的功能，而迷你埠驅動程式可以使用適當的狀態碼傳送 NDIS_STATUS_PM_WOL_PATTERN_REJECTED 狀態指示。