OID_SRIOV_CURRENT_CAPABILITIES

上位ドライバーは、ネットワークアダプタの現在の単一ルート I/O 仮想化 (SR-IOV) 機能を取得する OID_SRIOV_CURRENT_CAPABILITIES のオブジェクト識別子(OID)クエリ要求を発行します。

この 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

情報バッファーが短すぎました。 ミニポートドライバーは、 NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバー に必要最小限のバッファーを設定する必要があります。

NDIS_STATUS_FAILURE

その他の理由で要求に失敗しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_OID_REQUEST

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_SRIOV_CAPABILITIES

NdisMSetMiniportAttributes