共用方式為


OID_NIC_SWITCH_CURRENT_CAPABILITIES

過度的驅動程式發出OID_NIC_SWITCH_CURRENT_CAPABILITIES的物件標識碼 (OID) 查詢要求,以取得網路適配器中 NIC 交換器目前啟用的硬體功能。

從 OID 查詢要求成功傳回之後,InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_NIC_SWITCH_CAPABILITIES 結構的指標。

言論

從 NDIS 6.20 開始,迷你埠驅動程式會在呼叫 miniportInitializeEx函式時,在網路適配器上提供目前啟用的 NIC 交換器硬體功能。 驅動程式會使用 NIC 交換器硬體功能初始化 NDIS_NIC_SWITCH_CAPABILITIES 結構,並將 CurrentNicSwitchCapabilitiesNDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構的成員設定為 NDIS_NIC_SWITCH_CAPABILITIES 結構的指標。 迷你埠驅動程序接著會呼叫 NdisMSetMiniportAttributes 函式,並將 MiniportAttributes 參數設定為 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構的指標。

附註 從 NDIS 6.30 開始,支援單一根 I/O 虛擬化 (SR-IOV) 介面的迷你埠驅動程式必須註冊 NIC 交換器啟用的硬體功能。 驅動程式藉由呼叫 NdisMSetMiniportAttributes來註冊這些功能。

過度配置通訊協議和篩選驅動程式不需要發出OID_NIC_SWITCH_CURRENT_CAPABILITIES的 OID 查詢要求。 NDIS 會以下列方式,為這些驅動程式提供網路適配器目前啟用的 NIC 交換器硬體功能:

  • NDIS 會報告基礎網路適配器目前啟用的 NIC 交換器硬體功能,以在系結作業期間,將 NicSwitchCapabilities 中NDIS_BIND_PARAMETERS 結構的成員過度配置通訊協定驅動程式。

  • NDIS 會報告基礎網路適配器目前啟用的 NIC 交換器硬體功能,以在連接作業期間,將 NicSwitchCapabilities 中的篩選器驅動程式過度篩選NDIS_FILTER_ATTACH_PARAMETERS 結構的成員。

傳回狀態代碼

NDIS 會處理迷你埠驅動程式OID_NIC_SWITCH_CURRENT_CAPABILITIES要求的 OID 查詢要求。 驅動程式將不會發出此 OID 要求。

當 NDIS 處理OID_NIC_SWITCH_CURRENT_CAPABILITIES要求時,它會傳回下列其中一個狀態代碼:

狀態代碼 描述

NDIS_STATUS_SUCCESS

要求成功完成。 InformationBuffer 指向 NDIS_NIC_SWITCH_CAPABILITIES 結構。

NDIS_STATUS_NOT_SUPPORTED

迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面,或未啟用使用 介面。

NDIS_STATUS_INVALID_LENGTH

信息緩衝區的長度小於sizeof(NDIS_NIC_SWITCH_CAPABILITIES)。 迷你埠驅動程序必須設定 DATA。QUERY_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。

NDIS_STATUS_FAILURE

要求因其他原因而失敗。

要求

版本

NDIS 6.20 和更新版本支援。

頁眉

Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST