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 を含む) |