NDIS_SRIOV_CAPABILITIES 結構 (ntddndis.h)

發行項
02/29/2024

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

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

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 功能：

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