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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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) |