OID_SRIOV_HARDWARE_CAPABILITIES

發行項
06/15/2023

過度處理驅動程式會發出物件識別碼， (OID) 查詢要求OID_SRIOV_HARDWARE_CAPABILITIES，以取得網路介面卡的單一根目錄 I/O 虛擬化 (SR-IOV) 硬體功能。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_SRIOV_CAPABILITIES結構的指標。

備註

NDIS_SRIOV_CAPABILITIES結構包含網路介面卡的硬體功能相關資訊，例如介面卡是否支援 SR-IOV，以及迷你埠驅動程式是否管理介面卡的 PCI Express (PCIe) 實體函式 (PF) 或虛擬函式 (VF) 。這些功能可以包含 INF 檔案設定目前停用的硬體功能，或透過 [ 進階屬性] 頁面停用。

注意網路介面卡的所有 SR-IOV 功能都會透過OID_SRIOV_HARDWARE_CAPABILITIES的 OID 查詢要求傳回，不論是否已啟用或停用功能。

從 NDIS 6.30 開始，迷你埠驅動程式會在呼叫 其 MiniportInitializeEx 函式時提供 SR-IOV 硬體功能。驅動程式會使用 SR-IOV 硬體功能初始化NDIS_SRIOV_CAPABILITIES結構，並將NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES結構的HardwareSriovCapabilities成員設定為NDIS_SRIOV_CAPABILITIES結構的指標。迷你埠驅動程式接著會呼叫 NdisMSetMiniportAttributes 函式，並將 MiniportAttributes 參數設定為 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構的指標。

傳回狀態碼

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

當 NDIS 處理OID_SRIOV_HARDWARE_CAPABILITIES要求時，它會傳回下列其中一個狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	OID 要求已順利完成。
NDIS_STATUS_NOT_SUPPORTED	迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面，或未啟用該介面。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太短。迷你埠驅動程式必須設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。