NdisIfFreeNetLuidIndex-Funktion (ndis.h)
Die NdisIfFreeNetLuidIndex-Funktion gibt eine Netzwerkschnittstelle NET_LUID Index frei, die zuvor durch einen Aufruf des zugeordnet wurde. NdisIfAllocateNetLuidIndex-Funktion .
Syntax
NDIS_STATUS NdisIfFreeNetLuidIndex(
NET_IFTYPE ifType,
[in] UINT32 NetLuidIndex
);
Parameter
ifType
Der Schnittstellentyp, für den der Index zugeordnet wurde. Der Aufrufer muss denselben Wert angeben, den er verwendet hat, als er den NET_LUID Index mit NdisIfAllocateNetLuidIndex zugeordnet hat. Eine Liste der Schnittstellentypen finden Sie unter NDIS-Schnittstellentypen.
[in] NetLuidIndex
Der NET_LUID Indexwert, den NDIS frei geben soll. Dieser Index wurde in einem vorherigen Aufruf von NdisIfAllocateNetLuidIndex zugeordnet.
Rückgabewert
NdisIfFreeNetLuidIndex gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Fehler bei NdisIfFreeNetLuidIndex, weil der NetLuidIndex-Parameter einen Index angegeben hat, der nicht für den Typ zugeordnet wurde, den der IfType-Parameter angegeben hat. |
Wenn der Aufruf von NdisIfFreeNetLuidIndex fehlschlägt, sollte der Schnittstellenanbieter alle Informationen entfernen, die er im persistenten Speicher gespeichert hat, der sich auf den Index bezieht. Wenn Sie die Informationen entfernen, wird sichergestellt, dass der Anbieter nicht ständig versucht, einen Index frei zu geben, der nach dem Neustart des Computers bereits freigegeben wurde.
Hinweise
NDIS-Schnittstellenanbieter rufen die NdisIfFreeNetLuidIndex-Funktion auf, um einen NET_LUID Index freizugeben. Der Schnittstellenanbieter sollte den NET_LUID Index nur freigeben, wenn die Schnittstelle auf dem lokalen Computer nicht mehr verwendet wird.
NdisIfFreeNetLuidIndex gibt einen zuvor zugeordneten NET_LUID Index an NDIS zurück, um eine mögliche Neuzuordnung auf eine andere Schnittstelle zu ermöglichen. Der Aufrufer muss denselben Schnittstellentyp an IfType übergeben, den er beim Aufrufen von verwendet hat. NdisIfAllocateNetLuidIndex-Funktion , um den NET_LUID Index zuzuordnen.
Der Anbieter sollte den freigegebenen NET_LUID Index oder den zugeordneten NET_LUID-Wert nicht in anderen NDIS-Funktionsaufrufen verwenden, nachdem er NdisIfFreeNetLuidIndex aufgerufen hat.
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) |