OID_PM_WOL_PATTERN_LIST

發行項
06/15/2023

查詢時，過度配置驅動程式可以使用 OID_PM_WOL_PATTERN_LIST OID 來列舉基礎網路介面卡上設定的網路喚醒模式。從查詢成功傳回之後，NDIS_OID_REQUEST結構的InformationBuffer成員會包含描述目前新增的 WOL 模式之NDIS_PM_WOL_PATTERN結構的指標。

備註

NDIS 會處理迷你埠驅動程式的查詢。 NDIS 驅動程式可以使用 OID_PM_WOL_PATTERN_LIST OID 來取得基礎網路介面卡上設定的網路喚醒模式清單。

針對清單中的每個NDIS_PM_WOL_PATTERN結構，NDIS 會將NextWoLPatternOffset成員設定為 OID 資訊緩衝區開頭的位移 (，也就是NDIS_OID_REQUEST結構InformationBuffer成員指向清單中下一個NDIS_PM_WOL_PATTERN) 結構的開頭。清單中最後一個結構之 NextWoLPatternOffset 成員中的位移為零。

例如，對於NextWoLPatternOffset (NDIS_PM_WOL_PATTERN 結構中的位移，NameBufferOffset) ，NDIS 會提供相對於每個NDIS_PM_WOL_PATTERN結構開頭的位移。

如果網路介面卡上沒有設定的 WOL 模式，NDIS 會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構的 BytesWritten成員為零，並傳回要求的NDIS_STATUS_SUCCESS。 DATA 中的資料。QUERY_INFORMATION。NDIS 不會修改 InformationBuffer成員。

NDIS 會針對要求傳回下列其中一個狀態碼：

NDIS_STATUS_SUCCESS
要求已順利完成。如果有任何， InformationBuffer 會包含 WOL 模式清單的指標。

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

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

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