OID_PM_CURRENT_CAPABILITIES

作為查詢,過度配置驅動程式可以使用 OID_PM_CURRENT_CAPABILITIES OID 來查詢網路介面卡目前可用的電源管理功能。 從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_PM_CAPABILITIES結構的指標。

備註

NDIS 會處理迷你埠驅動程式的查詢。 從 NDIS 6.20 開始,迷你埠驅動程式會在初始化期間提供電源管理硬體功能。 不過,NDIS 可以從通訊協定驅動程式隱藏某些功能。 例如,當使用者停用部分或所有電源管理功能時,NDIS 可能會回報不同的功能。

請注意,NDIS 回報給通訊協定驅動程式的目前電源管理功能不一定與迷你埠驅動程式回報給 NDIS 的硬體功能相同。

NDIS 會報告基礎網路介面卡的電源管理功能,以在系結作業期間,將 powerManagementCapabilitiesEx 成員中 NDIS_BIND_PARAMETERS 結構的過度通訊協定驅動程式回報。 因此,通訊協定驅動程式不需要查詢 OID。

NDIS 發出 NDIS_STATUS_PM_CAPABILITIES_CHANGE 狀態指示,以報告電源管理功能中可供過度使用驅動程式的變更。

如果基礎網路介面卡有 NDIS 6.1 或較舊的迷你埠驅動程式,NDIS 會將基礎網路介面卡的電源管理功能轉譯為 NDIS_PM_CAPABILITIES 結構。

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

NDIS_STATUS_SUCCESS
要求已順利完成。 InformationBuffer指向NDIS_PM_CAPABILITIES結構。

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

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

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

規格需求

版本

NDIS 6.20 和更新版本支援。 未要求迷你埠驅動程式。 (請參閱<註解>區段)。

標頭

Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE