OID_SRIOV_CURRENT_CAPABILITIES

發行項
06/15/2023

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

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

備註

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

過度配置通訊協定和篩選驅動程式不需要發出OID_SRIOV_CURRENT_CAPABILITIES的 OID 查詢要求。 NDIS 會以下列方式為這些驅動程式提供網路介面卡目前啟用的 SR-IOV 功能：

NDIS 會報告基礎網路介面卡目前啟用的 SR-IOV 功能，以在系結作業期間，將NDIS_BIND_PARAMETERS結構之 SriovCapabilities成員中的通訊協定驅動程式過度配置。
NDIS 會報告基礎網路介面卡目前啟用的 SR-IOV 功能，以在附加作業期間過度篩選NDIS_FILTER_ATTACH_PARAMETERS結構之 SriovCapabilities成員中的驅動程式。

傳回狀態碼

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

當 NDIS 處理OID_SRIOV_CURRENT_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	要求因其他原因而失敗。