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 會傳回下列其中一個值：

傳回碼	Description
NDIS_STATUS_SUCCESS	作業已成功完成。
NDIS_STATUS_RESOURCES	作業失敗，因為資源不足。

備註

NDIS 介面提供者會呼叫 NdisIfAllocateNetLuidIndex 函式 來配置NET_LUID 索引。 介面提供者必須先配置NET_LUID索引，介面提供者才能註冊介面。

NdisIfAllocateNetLuidIndex 會嘗試配置本機計算機唯一的 24 位NET_LUID索引，並與 IfType 參數指定的介面類型相關聯。 NDIS 會在永續性記憶體中記錄NET_LUID索引，讓索引即使在電腦重新啟動之後仍可維持與相同介面的關聯。 在介面提供者呼叫 NdisIfFreeNetLuidIndex 函式以釋放索引之後，NDIS 將不會配置相同的NET_LUID索引給 NdisIfAllocateNetLuidIndex 的未來呼叫端。

若要從 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)

另請參閱

NDIS_MAKE_NET_LUID

NET_LUID

NdisIfFreeNetLuidIndex

NdisIfRegisterInterface