OID_NIC_SWITCH_CURRENT_CAPABILITIES
過度處理驅動程式會發出物件識別碼, (OID) 查詢要求OID_NIC_SWITCH_CURRENT_CAPABILITIES,以取得網路介面卡中 NIC 交換器目前啟用的硬體功能。
從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_NIC_SWITCH_CAPABILITIES結構的指標。
備註
從 NDIS 6.20 開始,迷你埠驅動程式會在呼叫 其 MiniportInitializeEx 函式時,在網路介面卡上提供目前啟用的 NIC 交換器硬體功能。 驅動程式會使用 NIC 交換器硬體功能初始化NDIS_NIC_SWITCH_CAPABILITIES結構,並將NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES結構的CurrentNicSwitchCapabilities成員設定為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 交換器硬體功能,以在系結作業期間,將NDIS_BIND_PARAMETERS結構的NicSwitchCapabilities成員中的通訊協定驅動程式過度套用。
NDIS 會報告基礎網路介面卡目前啟用的 NIC 交換器硬體功能,以在附加作業期間過度篩選NDIS_FILTER_ATTACH_PARAMETERS結構的NicSwitchCapabilities成員中的驅動程式。
傳回狀態碼
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。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,到所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.20 和更新版本支援。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |