NDIS_SRIOV_CAPABILITIES-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_SRIOV_CAPABILITIES-Struktur gibt die Funktionen der Single Root-E/A-Virtualisierung (Single Root E/O Virtualization, 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;

Member

Header

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

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_SRIOV_CAPABILITIES-Struktur anzugeben, muss der Treiber das Revisionselement des Headers auf den folgenden Wert festlegen:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Ursprüngliche Version 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 Element ist für NDIS reserviert.

SriovCapabilities

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

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

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

Hinweis Dieses Flag darf nur vom Miniporttreiber für die PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters festgelegt werden. Dieser Treiber wird im Verwaltungsbetriebssystem ausgeführt. Dieses Betriebssystem wird in der übergeordneten Hyper-V-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.

Hinweise

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

Der Miniporttreiber ruft die NdisMSetMiniportAttributes-Funktion über seine 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 er die Elemente HardwareSriovCapabilities und CurrentSriovCapabilities als NDIS_SRIOV_CAPABILITIES-Strukturen formatiert.
Wenn der Treiber eine OID-Abfrageanforderung von OID_SRIOV_HARDWARE_CAPABILITIES oder OID_SRIOV_CURRENT_CAPABILITIES erfolgreich verarbeitet, gibt er eine NDIS_SRIOV_CAPABILITIES-Struktur zurück.

NDIS übergibt die SR-IOV-Funktionen des Netzwerkadapters auf folgende Weise an treiber, die an den Netzwerkadapter gebunden sind:

Wenn NDIS die FilterAttach-Funktion eines überlastenden Filtertreibers 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-Element dieser Struktur enthält einen Zeiger auf eine NDIS_SRIOV_CAPABILITIES Struktur.
Wenn NDIS die ProtocolBindAdapterEx-Funktion eines überlappenden Protokolltreibers 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-Element dieser Struktur enthält einen Zeiger auf eine NDIS_SRIOV_CAPABILITIES Struktur.