NDIS_SRIOV_CAPABILITIES 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

NDIS_SRIOV_CAPABILITIES構造体は、ネットワークアダプターの単一ルート I/O 仮想化 (SR-IOV) 機能を指定します。

構文

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

メンバー

Header

NDIS_SRIOV_CAPABILITIES構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SRIOV_CAPABILITIES構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SRIOV_CAPABILITIES _REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています

SriovCapabilities

次のフラグのビットごとの OR を含む ULONG 値。

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

ネットワークアダプターが SR-IOV 機能をサポートすることを指定します。

メモこのフラグは、ネットワークアダプターの PCI Express (PCIe) 物理機能 (PF) のミニポートドライバーによってのみ設定する必要があります。このドライバーは、管理オペレーティングシステムで実行されます。このオペレーティングシステムは、Hyper-V 親パーティションで実行されます。

NDIS_SRIOV_CAPS_PF_MINIPORT

これが PF ミニポートドライバーであることを指定します。

NDIS_SRIOV_CAPS_VF_MINIPORT

これが PCIe 仮想関数 (VF) ミニポートドライバーであることを指定します。

注釈

ミニポートドライバーは、次の方法で SR-IOV 機能を報告する NDIS_SRIOV_CAPABILITIES 構造体を使用します。

ミニポートドライバーは、その MiniportInitializeEx 関数から NdisMSetMiniportAttributes 関数を呼び出し、MiniportAttributes パラメーターをNDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES構造体へのポインターに設定します。ドライバーは、 HardwareSriovCapabilities メンバーと CurrentSriovCapabilities メンバーをNDIS_SRIOV_CAPABILITIES構造体として書式設定することで、SR-IOV サポートをアドバタイズします。
ドライバーは、 OID_SRIOV_HARDWARE_CAPABILITIES または OID_SRIOV_CURRENT_CAPABILITIESの OID クエリ要求を正常に処理すると、 NDIS_SRIOV_CAPABILITIES 構造体を返します。

NDIS は、ネットワークアダプターの SR-IOV 機能を、次のようにネットワークアダプターにバインドする上にあるドライバーに渡します。

NDIS が基になるフィルタードライバーの FilterAttach 関数を呼び出すと、NDIS は AttachParameters パラメーターを介してネットワークアダプターの SR-IOV 機能を渡します。このパラメーターには、 NDIS_FILTER_ATTACH_PARAMETERS 構造体へのポインターが含まれています。この構造体の SriovCapabilities メンバーには、 NDIS_SRIOV_CAPABILITIES 構造体へのポインターが含まれています。
NDIS が基になるプロトコルドライバーの ProtocolBindAdapterEx 関数を呼び出すと、NDIS は BindParameters パラメーターを介してネットワークアダプターの SR-IOV 機能を渡します。このパラメーターには、 NDIS_FILTER_ATTACH_PARAMETERS 構造体へのポインターが含まれています。この構造体の SriovCapabilities メンバーには、 NDIS_SRIOV_CAPABILITIES 構造体へのポインターが含まれています。