GetInvertedIfStackTable 函式會擷取反向網路介面堆疊數據列專案的數據表,以指定介面堆疊上網路介面的關聯性。
語法
NETIOAPI_API GetInvertedIfStackTable(
_Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);
參數
-
數據表 [out]
緩衝區的指標,這個緩衝區會接收 MIB_INVERTEDIFSTACK_TABLE 結構中反向介面堆疊數據列專案的數據表。
傳回值
如果函式成功,GetInvertedIfStackTable 會傳回STATUS_SUCCESS。
如果函式失敗,GetInvertedIfStackTable 會傳回下列其中一個錯誤碼:
傳回碼 | 描述 |
---|---|
STATUS_INVALID_PARAMETER | 無效的參數已傳遞至函式。 如果在 table 參數 中傳遞 NULL 指標,就會傳回此錯誤。 |
STATUS_NOT_ENOUGH_MEMORY | 記憶體資源不足,無法完成作業。 |
STATUS_NOT_FOUND | 找不到介面堆疊專案。 |
其他 | 使用 FormatMessage 函式取得傳回錯誤的訊息字串。 |
言論
GetInvertedIfStackTable 函式會列舉本機電腦上介面堆疊上的實體和邏輯網路介面,並以反向形式傳回 MIB_INVERTEDIFSTACK_TABLE 結構中的資訊。
GetInvertedIfStackTable 傳回緩衝區中 Table 參數指向的MIB_INVERTEDIFSTACK_TABLE結構中的介面堆棧專案。 MIB_INVERTEDIFSTACK_TABLE 結構包含介面堆疊專案計數,以及每個介面堆疊專案之 MIB_INVERTEDIFSTACK_ROW 結構的陣列。
介面堆疊中介面之間的關聯性在於,HigherLayerInterfaceIndex 中具有索引的介面,MIB_INVERTEDIFSTACK_ROW結構 成員的介面緊接在 LowerLayerInterfaceIndex MIB_INVERTEDIFSTACK_ROW 結構成員的介面上方。
GetInvertedIfStackTable 配置記憶體給MIB_INVERTEDIFSTACK_TABLE結構和這個結構中的MIB_INVERTEDIFSTACK_ROW專案。 當不再需要這些傳回的結構時,您的驅動程式應該呼叫freeMibTable 來釋放記憶體。
請注意,傳回的 MIB_INVERTEDIFSTACK_TABLE 結構,Table 參數所指向的 ,可能包含 NumEntries MIB_INVERTEDIFSTACK_TABLE 成員與 Table 成員中第一個MIB_INVERTEDIFSTACK_ROW數位專案之間的邊框間距。 對齊的邊框間距也可能存在於MIB_INVERTEDIFSTACK_ROW數位項目之間。 任何對MIB_INVERTEDIFSTACK_ROW陣列專案的存取都應該假設填補可能存在。
要求
目標平臺 |
通用 |
版本 |
可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
頁眉 |
Netioapi.h (包括 Netioapi.h) |
圖書館 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |