共用方式為


OID_PM_ADD_WOL_PATTERN

一組 NDIS 通訊協定驅動程式會使用 OID_PM_ADD_WOL_PATTERN OID,將電源管理喚醒-LAN 模式新增至網路適配器。 InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_PM_WOL_PATTERN 結構的指標。

言論

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

通訊協定驅動程式可以在成功系結至基礎網路適配器之後新增 WOL 模式,並一旦擁有必要的數據(例如介面的 IP 位址)即可設定 WOL 模式。 通訊協定驅動程式也可以新增 WOL 模式,以回應一些其他電源管理事件通知,例如拒絕先前新增的 WOL 模式或卸除的通訊協定。

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

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

附註 模式識別碼是網路適配器上設定的每個模式的唯一值。 不過,所有迷你埠適配卡的模式標識符並非全域唯一的。

如果 NDIS 或基礎網路適配器移除 WOL 模式,則會產生 NDIS_STATUS_PM_WOL_PATTERN_REJECTED 狀態指示。 StatusBuffer 成員 NDIS_STATUS_INDICATION 結構包含已拒絕 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 會設定 數據。SET_INFORMATION。BytesNeeded NDIS_OID_REQUEST 結構中的成員,以達到所需的最小緩衝區大小。

NDIS_STATUS_NOT_SUPPORTED
網路適配器不支援要求的 WOL 模式。

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

要求

版本

NDIS 6.20 和更新版本支援。 迷你埠驅動程式的必要專案。

頁眉

Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

NDIS_STATUS_INDICATION

NDIS_STATUS_PM_WOL_PATTERN_REJECTED

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_ADD_WAKE_UP_PATTERN