共用方式為


OID_PM_PARAMETERS

作為查詢,通訊協定驅動程式可以使用 OID_PM_PARAMETERS OID 來查詢目前啟用之網路適配器的電源管理硬體功能。 從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST 結構 InformationBuffer 成員包含 NDIS_PM_PARAMETERS 結構的指標。

通訊協定驅動程式可以使用 OID_PM_PARAMETERS OID 來啟用或停用網路適配器目前的硬體功能。 通訊協議驅動程式提供 InformationBuffer 中 NDIS_PM_PARAMETERS 結構的指標,NDIS_OID_REQUEST 結構的成員。

言論

從 NDIS 6.20 開始,過度配置通訊協定和篩選驅動程式會使用OID_PM_PARAMETERS來查詢和設定目前啟用之網路適配器的電源管理硬體功能。

當過度的驅動程序查詢OID_PM_PARAMETERS OID 時,NDIS 會完成要求,而不需將它轉送至迷你埠驅動程式。 NDIS 會儲存要求的設定,並將其與其他這類要求的設定結合。 在 NDIS 將網路適配器轉換為低功率狀態之前,NDIS 會將設定要求傳送至迷你埠驅動程式,其中包含 NDIS 所儲存之所有要求的合併設定。

目前啟用的功能可以是硬體支援的一部分功能。 如需硬體支援之功能的詳細資訊,請參閱 OID_PM_HARDWARE_CAPABILITIES

附註 如果 NDIS 在 WakeUpFlags 中設定 NDIS_PM_PARAMETERS 結構 成員中的 NDIS_PM_SELECTIVE_SUSPEND_ENABLED 旗標,它會直接對迷你埠驅動程序發出 OID 集合要求OID_PM_PARAMETERS。 這可讓 NDIS 略過網路驅動程式堆疊中的驅動程式來處理。

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

NDIS_STATUS_SUCCESS
要求成功完成。

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

NDIS_STATUS_BUFFER_TOO_SHORT
信息緩衝區太短。 NDIS 會設定 數據。QUERY_INFORMATION。BytesNeeded NDIS_OID_REQUEST 結構中的成員,以達到所需的最小緩衝區大小。

NDIS_STATUS_INVALID_PARAMETER
要求失敗,因為它嘗試啟用基礎網路適配器不支援的功能。

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

要求

版本

NDIS 6.20 和更新版本支援。

頁眉

Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES