NDIS_MAKE_RID Makro (ndis.h)

Das NDIS_MAKE_RID Makro erstellt einen NDIS_VF_RID Wert aus PCI Express(PCIe)-Segment-, Bus-, Geräte- und Funktionsnummern. Der Miniporttreiber verwendet diesen Wert als PCIe Requestor ID (RID) für die PCIe Virtual Function (VF) eines Netzwerkadapters.

Syntax

void NDIS_MAKE_RID(
   _Segment,
   _Bus,
   _Function
);

Parameter

_Segment

Die PCIe-Segmentnummer für die Gruppe von PCIe-Bussen, an die das Gerät angeschlossen ist. Ein PCIe-Segment besteht aus einer Reihe von PCIe-Bussen, die den Konfigurationsraum gemeinsam nutzen.

_Bus

Die PCIe-Busnummer des Busses, an den der Netzwerkadapter angefügt ist.

_Function

Die Funktionsnummer eines logischen Geräts auf dem Netzwerkadapter.

Rückgabewert

NDIS_MAKE_RID gibt einen NDIS_VF_RID Wert zurück, der aus den Parametern erstellt wird.

Hinweise

Wenn eine OID-Anforderung von OID_NIC_SWITCH_ALLOCATE_VF verarbeitet wird, verwendet der Miniporttreiber für die physische PCIe-Funktion (PF) das Makro NDIS_MAKE_RID , um einen RID-Wert (PCIe Requestor ID) für den VF zu erstellen. Der Treiber ruft die PCIe-Segment-, Bus-, Geräte- und Funktionsnummern für den VF ab, indem er NdisMGetVirtualFunctionLocation aufruft.

Hinweis

Wenn ein unabhängiger Hardwareanbieter (IHV) einen virtuellen Bustreiber (VBD) als Teil seines SR-IOV-Treiberpakets bereitstellt, darf der PF-Miniporttreiber NdisMGetVirtualFunctionLocation nicht aufrufen. Stattdessen muss der Treiber über einen privaten Kommunikationskanal mit dem VBD kommunizieren und anfordern, dass der VBD GetLocation aufruft. Diese Funktion wird über die GUID_PCI_VIRTUALIZATION_INTERFACE-Schnittstelle verfügbar gemacht, die vom zugrunde liegenden PCI-Bustreiber unterstützt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h

Weitere Informationen

NdisMGetVirtualFunctionLocation

OID_NIC_SWITCH_ALLOCATE_VF