NdisIfAllocateNetLuidIndex 函式 （ndis.h）
NdisIfAllocateNetLuidIndex 函式會為 NDIS 網路介面提供者設定 NET_LUID 索引。
語法
NDIS_STATUS NdisIfAllocateNetLuidIndex(
NET_IFTYPE ifType,
[out] PUINT32 pNetLuidIndex
);
參數
ifType
索引的因特網指派數字授權單位 （IANA） 介面類型。 例如，IF_TYPE_ETHERNET_CSMACD （6） 是指派給任何乙太網路型介面 之 ifType 的值。 如需介面類型清單，請參閱 NDIS 介面類型。
[out] pNetLuidIndex
提供給呼叫端 NET_LUID 索引變數的指標。 如果配置成功，NdisIfAllocateNetLuidIndex 將此變數設定為配置的 24 位NET_LUID索引值。
傳回值
NdisIfAllocateNetLuidIndex 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
|
作業已順利完成。 |
|
作業失敗，因為資源不足。 |
言論
NDIS 介面提供者會呼叫 NdisIfAllocateNetLuidIndex 函式來設定 NET_LUID 索引。 介面提供者必須先配置NET_LUID索引，介面提供者才能註冊介面。
NdisIfAllocateNetLuidIndex 嘗試配置本機電腦唯一的 24 位NET_LUID索引，並與 ifType 參數所指定的介面類型相關聯。 NDIS 會記錄永續性記憶體中的NET_LUID索引，讓索引即使在電腦重新啟動之後仍可以維持與相同介面的關聯。 除非介面提供者呼叫 NdisIfFreeNetLuidIndex 函式，否則 NDIS 不會將相同的NET_LUID索引配置給 NdisIfAllocateNetLuidIn dex 的未來呼叫者。
若要從NET_LUID索引和介面類型建置 NET_LUID 值，介面提供者會呼叫 NDIS_MAKE_NET_LUID 巨集。
介面提供者必須儲存其配置在永續性記憶體中的NET_LUID值。 例如，如果計算機電源遺失，提供者應該已將NET_LUID值儲存在持續性記憶體中，以便稍後呼叫 NdisIfFreeNetLuidIndex，以釋放不再使用的任何索引。 此外，每當提供者向 註冊相同的介面時，提供者應該使用相同的NET_LUID值 NdisIfRegisterInterface 函式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 目標平臺 | 桌面 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | Irql_Interfaces_Function（ndis） |