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 結構。

迷你埠驅動程序必須將標頭的 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SRIOV_CAPABILITIES 結構的版本，驅動程式必須將 Revision member of Header 設定為下列值：

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）迷你埠驅動程式。

言論

迷你埠驅動程式會使用 NDIS_SRIOV_CAPABILITIES 結構，以下列方式報告其 SR-IOV 功能：

miniport 驅動程式會從 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 結構的指標。