作為查詢,通訊協定驅動程式可以使用 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_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) |