NDIS_SRIOV_CAPABILITIES Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SRIOV_CAPABILITIES-Struktur gibt die Funktionen der einzelnen Stamm-E/A-Virtualisierung (SR-IOV) des Netzwerkadapters an.

Syntax

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

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SRIOV_CAPABILITIES Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_SRIOV_CAPABILITIES-Struktur anzugeben, muss der Treiber den Revision Member Header- auf den folgenden Wert festlegen:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das element Größe auf NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Mitglied ist für NDIS reserviert.

SriovCapabilities

Ein ULONG-Wert, der ein bitweises ODER der folgenden Flags enthält:

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Gibt an, dass der Netzwerkadapter SR-IOV Funktionalität unterstützt.

Hinweis Dieses Kennzeichen darf nur vom Miniporttreiber für die PHYSISCHE Funktion PCI Express (PCIe) des Netzwerkadapters festgelegt werden. Dieser Treiber wird im Verwaltungsbetriebssystem ausgeführt. Dieses Betriebssystem wird in der Hyper-V übergeordneten Partition ausgeführt.

NDIS_SRIOV_CAPS_PF_MINIPORT

Gibt an, dass es sich um einen PF-Miniporttreiber handelt.

NDIS_SRIOV_CAPS_VF_MINIPORT

Gibt an, dass es sich um einen PCIe Virtual Function (VF)-Miniporttreiber handelt.

Bemerkungen

Der Miniporttreiber verwendet die NDIS_SRIOV_CAPABILITIES Struktur, um seine SR-IOV Funktionen auf folgende Weise zu melden:

Der Miniport-Treiber ruft die NdisMSetMiniportAttributes--Funktion aus der MiniportInitializeEx- Funktion auf und legt den MiniportAttributes Parameter auf einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur fest. Der Treiber kündigt SR-IOV Unterstützung an, indem die HardwareSriovCapabilities und CurrentSriovCapabilities Member als NDIS_SRIOV_CAPABILITIES Strukturen formatiert werden.
Wenn der Treiber erfolgreich eine OID-Abfrageanforderung von OID_SRIOV_HARDWARE_CAPABILITIES oder OID_SRIOV_CURRENT_CAPABILITIESverarbeitet, wird eine NDIS_SRIOV_CAPABILITIES Struktur zurückgegeben.

NDIS übergibt die SR-IOV-Funktionen des Netzwerkadapters an übersteigende Treiber, die auf folgende Weise an den Netzwerkadapter gebunden werden:

Wenn NDIS die FilterAttach-Funktion eines Überlauffiltertreibers aufruft, übergibt NDIS die SR-IOV-Funktionen des Netzwerkadapters über den AttachParameters Parameter. Dieser Parameter enthält einen Zeiger auf eine NDIS_FILTER_ATTACH_PARAMETERS Struktur. Das SriovCapabilities Mitglied dieser Struktur enthält einen Zeiger auf eine NDIS_SRIOV_CAPABILITIES Struktur.
Wenn NDIS die ProtocolBindAdapterEx--Funktion eines Überlaufprotokolltreibers aufruft, übergibt NDIS die SR-IOV Funktionen des Netzwerkadapters über den BindParameters Parameter. Dieser Parameter enthält einen Zeiger auf eine NDIS_FILTER_ATTACH_PARAMETERS Struktur. Das SriovCapabilities Mitglied dieser Struktur enthält einen Zeiger auf eine NDIS_SRIOV_CAPABILITIES Struktur.