OID_PM_PARAMETERS
作為查詢,通訊協定驅動程式可以使用 OID_PM_PARAMETERS OID 來查詢目前已啟用之網路介面卡的電源管理硬體功能。 從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_PM_PARAMETERS結構的指標。
一組通訊協定驅動程式可以使用 OID_PM_PARAMETERS OID 來啟用或停用網路介面卡目前的硬體功能。 通訊協定驅動程式會在 NDIS_OID_REQUEST 結構的InformationBuffer 成員中,提供 NDIS_PM_PARAMETERS 結構的指標。
備註
從 NDIS 6.20 開始,過度配置通訊協定和篩選驅動程式會使用OID_PM_PARAMETERS來查詢和設定目前啟用之網路介面卡的電源管理硬體功能。
當過度的驅動程式查詢OID_PM_PARAMETERS OID 時,NDIS 會完成要求,而不需要將它轉送至迷你埠驅動程式。 NDIS 會儲存要求的設定,並將其與其他這類要求的設定結合。 在 NDIS 將網路介面卡轉換為低電源狀態之前,NDIS 會將設定要求傳送至迷你埠驅動程式,其中包含 NDIS 儲存之所有要求的合併設定。
目前啟用的功能可以是硬體所支援功能的子集。 如需硬體支援功能的詳細資訊,請參閱 OID_PM_HARDWARE_CAPABILITIES。
注意如果 NDIS 在NDIS_PM_PARAMETERS 結構的WakeUpFlags成員中設定NDIS_PM_SELECTIVE_SUSPEND_ENABLED旗標,它會將 OID_PM_PARAMETERS 的 OID 集合要求直接發出至迷你埠驅動程式。 這可讓 NDIS 略過網路驅動程式堆疊中的驅動程式處理。
NDIS 或迷你埠驅動程式會針對要求傳回下列其中一個狀態碼:
NDIS_STATUS_PENDING
要求擱置完成。 NDIS 會在要求完成之後,將最終狀態代碼和結果傳遞至呼叫端的 OID 要求完成處理常式。
NDIS_STATUS_BUFFER_TOO_SHORT
資訊緩衝區太短。 NDIS 會設定 資料。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded 成員到所需的緩衝區大小下限。
NDIS_STATUS_INVALID_PARAMETER
要求失敗,因為它嘗試啟用基礎網路介面卡不支援的功能。
NDIS_STATUS_FAILURE
要求因上述原因以外的原因而失敗。
規格需求
版本 |
NDIS 6.20 和更新版本支援。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |