OID_PM_ADD_WOL_PATTERN

發行項
06/14/2023

如同一組，NDIS 通訊協定驅動程式會使用 OID_PM_ADD_WOL_PATTERN OID，將電源管理網路喚醒模式新增至網路介面卡。 NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_PM_WOL_PATTERN結構的指標。

備註

NDIS 6.20 和更新版本的通訊協定驅動程式會使用 OID_PM_ADD_WOL_PATTERN，將網路喚醒 (WOL) 模式新增至網路介面卡。 OID 要求包含網路介面卡在處於低電源狀態時，網路介面卡必須與傳入封包進行比較的準則。網路介面卡在收到符合模式準則的封包時，必須產生喚醒事件。

通訊協定驅動程式可以在成功系結至基礎網路介面卡之後新增 WOL 模式，並在有必要的資料 (，例如介面的 IP 位址) 來設定 WOL 模式。通訊協定驅動程式也可以新增 WOL 模式，以回應一些其他電源管理事件通知，例如拒絕先前新增的 WOL 模式或卸載通訊協定。

若要避免 NDIS 和其他系結至相同迷你埠介面卡的通訊協定驅動程式中的競爭狀況，在 NDIS 開始將網路介面卡設定為低電源狀態之後，任何嘗試將新的喚醒模式新增至該網路介面卡時，都會失敗。例如，如果 NDIS 通訊協定驅動程式嘗試在該網路介面卡處理 NetEventSetPower 事件通知的內容中新增 WOL 模式，NDIS 將會失敗要求。

在 NDIS 將這個 OID 要求向下傳送至基礎 NDIS 驅動程式或完成對過度配置驅動程式的要求之前，它會將NDIS_PM_WOL_PATTERN結構的 ULONG PatternId成員設定為唯一值。通訊協定驅動程式和 NDIS 使用此模式識別碼搭配 OID_PM_REMOVE_WOL_PATTERN OID 要求，以從基礎網路介面卡移除 WOL 模式。

注意模式識別碼是網路介面卡上設定之每個模式的唯一值。不過，在所有迷你埠配接器上，模式識別碼不是全域唯一的。

如果 NDIS 或基礎網路介面卡移除 WOL 模式，它會產生 NDIS_STATUS_PM_WOL_PATTERN_REJECTED 狀態指示。 NDIS_STATUS_INDICATION結構的StatusBuffer成員包含拒絕的 WOL 模式的 ULONG WOL 模式識別碼。

迷你埠驅動程式會針對要求傳回下列其中一個狀態碼：

NDIS_STATUS_SUCCESS
已成功新增要求的模式。 NDIS_PM_WOL_PATTERN 結構的 PatternId 成員包含模式識別碼。

NDIS_STATUS_PENDING
要求正在擱置完成。 NDIS 會在要求完成之後，將最終狀態代碼和結果傳遞至呼叫端的 OID 要求完成處理常式。

NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
要求失敗，因為模式清單已滿，而且網路介面卡無法新增另一個模式。

NDIS_STATUS_RESOURCES
由於缺少資源，NDIS 或基礎網路介面卡無法新增模式。

NDIS_STATUS_INVALID_PARAMETER
NDIS_PM_WOL_PATTERN 結構中的一或多個參數無效。

NDIS_STATUS_BUFFER_TOO_SHORT
資訊緩衝區太短。 NDIS 會設定 DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded 成員，以達到所需的最小緩衝區大小。

NDIS_STATUS_NOT_SUPPORTED
網路介面卡不支援要求的 WOL 模式。

NDIS_STATUS_FAILURE
要求因上述原因以外的原因而失敗。