NdisIfAllocateNetLuidIndex-Funktion (ndis.h)
Die NdisAllocateNetLuidIndex--Funktion weist einen NET_LUID Index für einen NDIS-Netzwerkschnittstellenanbieter zu.
Syntax
NDIS_STATUS NdisIfAllocateNetLuidIndex(
NET_IFTYPE ifType,
[out] PUINT32 pNetLuidIndex
);
Parameter
ifType
Der Schnittstellentyp Internet Assigned Numbers Authority (IANA) für einen Index. Beispielsweise ist IF_TYPE_ETHERNET_CSMACD (6) der Wert für IfType-, der einer beliebigen Ethernet-ähnlichen Schnittstelle zugewiesen ist. Eine Liste der Schnittstellentypen finden Sie unter NDIS-Schnittstellentypen.
[out] pNetLuidIndex
Ein Zeiger auf eine vom Aufrufer bereitgestellte NET_LUID Indexvariable. Wenn die Zuordnung erfolgreich ist, legt NdisAllocateNetLuidIndex diese Variable auf den zugewiesenen 24-Bit-NET_LUID Indexwert fest.
Rückgabewert
NdisIfAllocateNetLuidIndex gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Fehler beim Vorgang aufgrund unzureichender Ressourcen. |
Bemerkungen
NDIS-Schnittstellenanbieter rufen die NdisAllocateNetLuidIndex--Funktion auf, um einen NET_LUID Index zuzuweisen. Ein Schnittstellenanbieter muss einen NET_LUID Index zuweisen, bevor der Schnittstellenanbieter eine Schnittstelle registrieren kann.
NdisIfAllocateNetLuidIndex versucht, einen 24-Bit-NET_LUID Index zuzuweisen, der für den lokalen Computer eindeutig ist und dem Schnittstellentyp zugeordnet ist, den der IfType Parameter angibt. NDIS zeichnet den NET_LUID Index im beständigen Speicher auf, sodass der Index auch nach dem Neustart des Computers derselben Schnittstelle zugeordnet bleiben kann. NDIS weist den zukünftigen Aufrufern von NdisAllocateNetLuidIndex nicht denselben NET_LUID Index zu, bis der Schnittstellenanbieter den NdisIfFreeNetLuidIndex Funktion aufruft, um den Index freizugeben.
Zum Erstellen eines NET_LUID Werts aus dem NET_LUID Index und dem Schnittstellentyp ruft ein Schnittstellenanbieter das NDIS_MAKE_NET_LUID Makro auf.
Der Schnittstellenanbieter muss die NET_LUID Werte speichern, die er im beständigen Speicher zuweist. Wenn beispielsweise ein Computerstromverlust besteht, sollte der Anbieter die NET_LUID Werte im beständigen Speicher gespeichert haben, damit er NdisFreeNetLuidIndex später aufrufen kann, um alle Indizes freizulegen, die nicht mehr verwendet werden. Außerdem sollte der Anbieter den gleichen NET_LUID Wert verwenden, wenn er dieselbe Schnittstelle mit der NdisIfRegisterInterface Funktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Interfaces_Function(ndis) |