Fungsi GetIfStackTable
Fungsi GetIfStackTable mengambil tabel entri baris tumpukan antarmuka jaringan yang menentukan hubungan antarmuka jaringan pada tumpukan antarmuka.
Sintaksis
NETIOAPI_API GetIfStackTable(
_Out_ PMIB_IFSTACK_TABLE *Table
);
Parameter
-
Tabel [out]
Penunjuk ke buffer yang menerima tabel entri baris tumpukan antarmuka dalam struktur MIB_IFSTACK_TABLE.
Mengembalikan nilai
GetIfStackTable mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetIfStackTable mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika pointer NULL diteruskan dalam parameter Tabel. |
| STATUS_NOT_ENOUGH_MEMORY | Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi. |
| STATUS_NOT_FOUND | Tidak ada entri tumpukan antarmuka yang ditemukan. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Komentar
Fungsi GetIfStackTable menghitung antarmuka jaringan fisik dan logis pada tumpukan antarmuka pada komputer lokal dan mengembalikan informasi ini dalam struktur MIB_IFSTACK_TABLE.
Entri tumpukan antarmuka dikembalikan dalam struktur MIB_IFSTACK_TABLE di buffer yang dituju parameter Tabel. Struktur MIB_IFSTACK_TABLE berisi jumlah entri tumpukan antarmuka dan array struktur MIB_IFSTACK_ROW untuk setiap entri tumpukan antarmuka.
Hubungan antara antarmuka dalam tumpukan antarmuka adalah bahwa antarmuka dengan indeks di HigherLayerInterfaceIndex anggota struktur MIB_IFSTACK_ROW berada tepat di atas antarmuka dengan indeks di LowerLayerInterfaceIndex anggota struktur MIB_IFSTACK_ROW.
Memori dialokasikan oleh fungsi GetIfStackTable untuk struktur MIB_IFSTACK_TABLE dan entri MIB_IFSTACK_ROW dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, driver Anda harus membebaskan memori dengan memanggil FreeMibTable.
Perhatikan bahwa struktur MIB_IFSTACK_TABLE yang dikembalikan yang ditunjukkan parameter Tabel mungkin berisi padding untuk perataan antara anggota NumEntries dan entri array MIB_IFSTACK_ROW pertama di Tabel anggota struktur MIB_IFSTACK_TABLE. Padding untuk perataan mungkin juga ada di antara entri array MIB_IFSTACK_ROW. Akses apa pun ke entri array MIB_IFSTACK_ROW harus mengasumsikan padding mungkin ada.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Perpustakaan |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |