NDIS_SRIOV_CAPABILITIES構造体 (ntddndis.h)

[アーティクル]
02/07/2025

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 構造体として書式設定されます。

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

NDIS_SRIOV_CAPABILITIES _REVISION_1

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

Size メンバーを 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 構造を使用します。

ミニポートドライバーは、ミニポートInitializeEx 関数から NdisMSetMiniportAttributes 関数を呼び出し、ミニポートAttributes パラメーターを NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 構造体へのポインターに設定します。ドライバーは、HardwareSriovCapabilities を書式設定し、NDIS_SRIOV_CAPABILITIES 構造体としてメンバー CurrentSriovCapabilities を することで、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 構造体へのポインターが含まれています。

ネットワークアダプターの SR-IOV 機能を報告する方法の詳細については、「SR-IOV 機能の決定を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.30 以降でサポートされています。
ヘッダー	ntddndis.h (Ndis.h を含む)

次の方法で共有