NdisIfFreeNetLuidIndex 函式 (ndis.h)
NdisIfFreeNetLuidIndex 函式會釋放網路介面NET_LUID索引,該網路介面先前由呼叫所配置 NdisIfAllocateNetLuidIndex 函 式。
語法
NDIS_STATUS NdisIfFreeNetLuidIndex(
NET_IFTYPE ifType,
[in] UINT32 NetLuidIndex
);
參數
ifType
已配置索引的介面類型。 呼叫端必須提供與 NdisIfAllocateNetLuidIndex 配置NET_LUID索引時所使用的相同值。 如需介面類型清單,請參閱 NDIS 介面類型。
[in] NetLuidIndex
NDIS 應該釋放的NET_LUID索引值。 此索引是在先前呼叫 NdisIfAllocateNetLuidIndex 中配置。
傳回值
NdisIfFreeNetLuidIndex 會傳回下列其中一個值:
傳回碼 | Description |
---|---|
|
作業已成功完成。 |
|
NdisIfFreeNetLuidIndex 失敗,因為 NetLuidIndex 參數指定了未配置給 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) |