GetInvertedIfStackTable 函式
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 結構陣列。
介面堆疊中介面之間的關聯性是MIB_INVERTEDIFSTACK_ROW結構 之 HigherLayerInterfaceIndex 成員中索引的介面緊接在 MIB_INVERTEDIFSTACK_ROW 結構的 LowerLayerInterfaceIndex 成員中索引的介面上方。
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 |