Fungsi GetInvertedIfStackTable
Fungsi GetInvertedIfStackTable mengambil tabel entri baris tumpukan antarmuka jaringan terbalik yang menentukan hubungan antarmuka jaringan pada tumpukan antarmuka.
Sintaks
NETIOAPI_API GetInvertedIfStackTable(
_Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);
Parameter
- Tabel [keluar]
Penunjuk ke buffer yang menerima tabel entri baris tumpukan antarmuka terbalik dalam struktur MIB_INVERTEDIFSTACK_TABLE .
Mengembalikan nilai
GetInvertedIfStackTable mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetInvertedIfStackTable mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk 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. |
Keterangan
Fungsi GetInvertedIfStackTable menghitung antarmuka jaringan fisik dan logis pada tumpukan antarmuka pada komputer lokal dan mengembalikan informasi ini dalam bentuk terbalik dalam struktur MIB_INVERTEDIFSTACK_TABLE .
GetInvertedIfStackTable mengembalikan entri tumpukan antarmuka dalam struktur MIB_INVERTEDIFSTACK_TABLE dalam buffer yang ditunjukkan parameter Tabel . Struktur MIB_INVERTEDIFSTACK_TABLE berisi jumlah entri tumpukan antarmuka dan array struktur MIB_INVERTEDIFSTACK_ROW untuk setiap entri tumpukan antarmuka.
Hubungan antara antarmuka dalam tumpukan antarmuka adalah bahwa antarmuka dengan indeks di anggota HigherLayerInterfaceIndex dari struktur MIB_INVERTEDIFSTACK_ROW berada tepat di atas antarmuka dengan indeks di anggota LowerLayerInterfaceIndex dari struktur MIB_INVERTEDIFSTACK_ROW.
GetInvertedIfStackTable mengalokasikan memori untuk struktur MIB_INVERTEDIFSTACK_TABLE dan entri MIB_INVERTEDIFSTACK_ROW dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, driver Anda harus membebaskan memori dengan memanggil FreeMibTable.
Perhatikan bahwa struktur MIB_INVERTEDIFSTACK_TABLE yang dikembalikan yang ditunjuk parameter Tabel mungkin berisi padding untuk perataan antara anggota NumEntries dan entri array MIB_INVERTEDIFSTACK_ROW pertama di anggota Tabel dari struktur MIB_INVERTEDIFSTACK_TABLE. Padding untuk perataan mungkin juga ada di antara entri array MIB_INVERTEDIFSTACK_ROW. Akses apa pun ke entri array MIB_INVERTEDIFSTACK_ROW harus mengasumsikan padding mungkin ada.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Pustaka |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |