NdisIfFreeNetLuidIndex 函式 (ndis.h)
NdisIfFreeNetLuidIndex 函式會釋放先前由 呼叫 所配置的網路介面 NET_LUID 索引 NdisIfAllocateNetLuidIndex 函式。
語法
NDIS_STATUS NdisIfFreeNetLuidIndex(
NET_IFTYPE ifType,
[in] UINT32 NetLuidIndex
);
參數
ifType
已配置索引的介面類型。 呼叫端必須提供它配置NET_LUID索引與 NdisIfAllocateNetLuidIndex時所使用的相同值。 如需介面類型清單,請參閱 NDIS 介面類型。
[in] NetLuidIndex
NDIS 應該釋放NET_LUID索引值。 此索引是在先前呼叫 NdisIfAllocateNetLuidIndex中配置。
傳回值
NdisIfFreeNetLuidIndex 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
|
作業已順利完成。 |
|
NdisIfFreeNetLuidIndex 失敗,因為 NetLuidIndex 參數指定了未配置給指定 ifType IfType 參數類型的索引。 |
如果呼叫 NdisIfFreeNetLuidIndex 失敗,介面提供者應該移除儲存在與索引相關之持續性記憶體中的任何資訊。 拿掉資訊可確保提供者不會繼續嘗試釋放電腦重新啟動后已釋放的索引。
言論
NDIS 介面提供者會呼叫 NdisIfFreeNetLuidIndex 函式來釋放 NET_LUID 索引。 只有當本機計算機上不再使用介面時,介面提供者才應該釋放NET_LUID索引。
NdisIfFreeNetLuidIndex 會傳回先前配置的NET_LUID索引給 NDIS,以便可能重新配置到另一個介面。 呼叫端必須傳入相同介面類型,IfType 呼叫 時所使用的介面類型 NdisIfAllocateNetLuidIndex 函式來配置NET_LUID索引。
提供者不應該在呼叫 NdisIfFreeNetLuidIndex之後,於任何其他 NDIS 函數調用中使用釋放NET_LUID索引或相關聯的NET_LUID值。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Interfaces_Function(ndis) |