NdisIfAddIfStackEntry 函式 (ndis.h)
NdisIfAddIfStackEntry 函式會指定 NDIS 網路介面堆疊中兩個網路介面的順序。
語法
NDIS_STATUS NdisIfAddIfStackEntry(
[in] NET_IFINDEX HigherLayerIfIndex,
[in] NET_IFINDEX LowerLayerIfIndex
);
參數
[in] HigherLayerIfIndex
介面堆疊數據表中應該較高之介面的網路介面索引。
[in] LowerLayerIfIndex
介面堆疊數據表中應該較低之介面的網路介面索引。
傳回值
NdisIfAddIfStackEntry 會傳回下列其中一個狀態值:
傳回碼 | Description |
---|---|
|
作業已成功完成。 |
|
作業失敗,因為資源不足。 |
|
NdisIfAddIfStackEntry 失敗,因為 位於 HigherLayerIfIndex 或 LowerLayerIfIndex 的索引不是已註冊介面的索引。 |
備註
NDIS 驅動程式可以呼叫 NdisIfAddIfStackEntry 函式,以指定 NDIS 介面堆疊中兩個網路介面的順序。 NDIS Proxy 提供者會指定篩選模組和迷你埠配接器的順序。 NDIS 也會指定虛擬迷你埠與篩選中繼驅動程序的基礎迷你埠適配卡之間的關聯性。 不過,NDIS 不會指定 MUX 中繼驅動程式的堆疊順序。
NDIS 會維護來自 RFC 2863) ifStackTable (介面堆疊數據表。 NDIS 提供 NdisIfAddIfStackEntry 和 NdisIfDeleteIfStackEntry 函式可新增和刪除此數據表中的專案。
任何可以提供兩個介面之間堆疊順序關聯性相關信息的驅動程式都應該呼叫 NdisIfAddIfStackEntry 來填入介面堆疊數據表。 當介面取消註冊時,NDIS 會刪除介面的對應堆疊專案。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Interfaces_Function (ndis) |