OID_SRIOV_HARDWARE_CAPABILITIES
上位ドライバーは、ネットワーク アダプターの現在の単一ルート I/O 仮想化 (SR-IOV) ハードウェア機能を取得する OID_SRIOV_HARDWARE_CAPABILITIES のオブジェクト識別子 (OID) クエリ要求を発行します。
この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_SRIOV_CAPABILITIES 構造体へのポインターが含まれています。
解説
この NDIS_SRIOV_CAPABILITIES 構造体には、アダプターが SR-IOV をサポートしているかどうか、ミニポート ドライバーがアダプターの PCI Express (PCIe) 物理関数 (PF) または仮想関数 (VF) を管理しているかどうかなど、ネットワーク アダプターのハードウェア機能に関する情報が含まれています。 これらの機能には、INF ファイルの設定または Advanced プロパティページによって現在無効にされているハードウェア機能を含めることができます。
注 ネットワーク アダプターのすべての SR-IOV 機能は、機能が有効か無効かに関係なく、OID_SRIOV_HARDWARE_CAPABILITIESの OID クエリ要求を通じて返されます。
NDIS 6.30以降、ミニポート ドライバーは MiniportInitializeEx 関数が呼び出されたときに、SR-IOV ハードウェア機能を提供します。 ドライバーは、 NDIS_SRIOV_CAPABILITIES 構造体を SR-IOV ハードウェア機能を使用して初期化し、 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 構造体の HardwareSriovCapabilities メンバーを NDIS_SRIOV_CAPABILITIES 構造体へのポインターに設定します。s その後、ミニポート ドライバーは 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 |
情報バッファーが短すぎました。 ミニポートドライバーは、 NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバー に必要最小限のバッファーを設定する必要があります。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |