NdisIfAllocateNetLuidIndex-Funktion (ndis.h)

Die NdisIfAllocateNetLuidIndex-Funktion ordnet einem NDIS-Netzwerkschnittstellenanbieter einen NET_LUID Index zu.

Syntax

NDIS_STATUS NdisIfAllocateNetLuidIndex(
        NET_IFTYPE ifType,
  [out] PUINT32    pNetLuidIndex
);

Parameter

ifType

Der IANA-Schnittstellentyp (Internet Assigned Numbers Authority) für einen Index. Beispielsweise ist IF_TYPE_ETHERNET_CSMACD (6) der Wert für IfType , der jeder 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 NdisIfAllocateNetLuidIndex diese Variable auf den zugeordneten 24-Bit-NET_LUID Indexwert fest.

Rückgabewert

NdisIfAllocateNetLuidIndex gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_RESOURCES	Der Vorgang ist aufgrund unzureichender Ressourcen fehlgeschlagen.

Hinweise

NDIS-Schnittstellenanbieter rufen die NdisIfAllocateNetLuidIndex-Funktion auf, um einen NET_LUID Index zuzuordnen. Ein Schnittstellenanbieter muss einen NET_LUID Index zuordnen, bevor der Schnittstellenanbieter eine Schnittstelle registrieren kann.

NdisIfAllocateNetLuidIndex versucht, einen 24-Bit-NET_LUID Index zuzuordnen, 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 persistenten Speicher auf, sodass der Index auch nach dem Neustart des Computers derselben Schnittstelle zugeordnet bleiben kann. NDIS weist denselben NET_LUID Index erst zukünftigen Aufrufenden von NdisIfAllocateNetLuidIndex zu, nachdem der Schnittstellenanbieter die NdisIfFreeNetLuidIndex-Funktion aufgerufen hat, um den Index freizugeben.

Um einen NET_LUID Wert aus dem NET_LUID Index und dem Schnittstellentyp zu erstellen, ruft ein Schnittstellenanbieter das Makro NDIS_MAKE_NET_LUID auf.

Der Schnittstellenanbieter muss die NET_LUID Werte speichern, die er im persistenten Speicher zuordnet. Wenn beispielsweise die Computerleistung verloren geht, sollte der Anbieter die NET_LUID Werte im persistenten Speicher gespeichert haben, damit er später NdisIfFreeNetLuidIndex aufrufen kann, um alle nicht mehr verwendeten Indizes freizuschalten. Außerdem sollte der Anbieter denselben NET_LUID Wert verwenden, wenn er dieselbe Schnittstelle bei der NdisIfRegisterInterface-Funktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Interfaces_Function(ndis)

Weitere Informationen

NDIS_MAKE_NET_LUID

NET_LUID

NdisIfFreeNetLuidIndex

NdisIfRegisterInterface