OID_NIC_SWITCH_HARDWARE_CAPABILITIES
過度配置驅動程式會在 OID (OID) 查詢要求發出OID_NIC_SWITCH_HARDWARE_CAPABILITIES,以取得網路介面卡中 NIC 交換器的硬體功能。
從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_NIC_SWITCH_CAPABILITIES結構的指標。
備註
NDIS_NIC_SWITCH_CAPABILITIES結構包含網路介面卡上 NIC 交換器硬體功能的相關資訊。 這些功能可以包含 INF 檔案設定目前停用或透過 [ 進階 屬性] 頁面停用的硬體功能。
注意 不論是否啟用或停用功能,指定 NIC 參數的所有功能都會透過 OID_NIC_SWITCH_HARDWARE_CAPABILITIES 的 OID 查詢要求傳回。
從 NDIS 6.20 開始,迷你埠驅動程式會在呼叫 MiniportInitializeEx 函式時提供 NIC 交換器硬體功能。 驅動程式會使用 NIC 交換器硬體功能初始化NDIS_NIC_SWITCH_CAPABILITIES結構,並將NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES結構的HardwareNicSwitchCapabilities成員設定為NDIS_NIC_SWITCH_CAPABILITIES結構的指標。 迷你埠驅動程式接著會呼叫 NdisMSetMiniportAttributes 函式,並將 MiniportAttributes 參數設定為 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構的指標。
注意 從 NDIS 6.30 開始,支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的迷你埠驅動程式必須註冊 NIC 交換器的硬體功能。 驅動程式會呼叫 NdisMSetMiniportAttributes來註冊這些功能。
傳回狀態碼
NDIS 會處理迷你埠驅動程式OID_NIC_SWITCH_HARDWARE_CAPABILITIES要求的 OID 查詢要求,並傳回下列其中一個狀態碼:
狀態碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
要求已順利完成。 InformationBuffer指向NDIS_NIC_SWITCH_CAPABILITIES結構。 |
NDIS_STATUS_NOT_SUPPORTED |
迷你埠驅動程式不支援單一根 I/O 虛擬化 (SR-IOV) 介面,或未啟用介面。 |
NDIS_STATUS_INVALID_LENGTH |
資訊緩衝區的長度小於大小 (NDIS_NIC_SWITCH_CAPABILITIES) 。 NDIS 會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,以達到所需的最小緩衝區大小。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.20 和更新版本支援。 |
標頭 |
Ntddndis.h (包括 Ndis.h) |