struktur MIB_IFROW (ifmib.h)

Struktur MIB_IFROW menyimpan informasi tentang antarmuka tertentu.

Sintaks

typedef struct _MIB_IFROW {
  WCHAR                   wszName[MAX_INTERFACE_NAME_LEN];
  IF_INDEX                dwIndex;
  IFTYPE                  dwType;
  DWORD                   dwMtu;
  DWORD                   dwSpeed;
  DWORD                   dwPhysAddrLen;
  UCHAR                   bPhysAddr[MAXLEN_PHYSADDR];
  DWORD                   dwAdminStatus;
  INTERNAL_IF_OPER_STATUS dwOperStatus;
  DWORD                   dwLastChange;
  DWORD                   dwInOctets;
  DWORD                   dwInUcastPkts;
  DWORD                   dwInNUcastPkts;
  DWORD                   dwInDiscards;
  DWORD                   dwInErrors;
  DWORD                   dwInUnknownProtos;
  DWORD                   dwOutOctets;
  DWORD                   dwOutUcastPkts;
  DWORD                   dwOutNUcastPkts;
  DWORD                   dwOutDiscards;
  DWORD                   dwOutErrors;
  DWORD                   dwOutQLen;
  DWORD                   dwDescrLen;
  UCHAR                   bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;

Anggota

wszName[MAX_INTERFACE_NAME_LEN]

Jenis: WCHAR[MAX_INTERFACE_NAME_LEN]

Penunjuk ke string Unicode yang berisi nama antarmuka.

dwIndex

Jenis: DWORD

Indeks yang mengidentifikasi antarmuka. Nilai indeks ini dapat berubah ketika adaptor jaringan dinonaktifkan lalu diaktifkan, dan tidak boleh dianggap persisten.

dwType

Jenis: DWORD

Jenis antarmuka seperti yang didefinisikan oleh Internet Assigned Names Authority (IANA). Untuk informasi selengkapnya, lihat http://www.iana.org/assignments/ianaiftype-mib. Nilai yang mungkin untuk jenis antarmuka tercantum dalam file header Ipifcons.h .

Tabel di bawah ini mencantumkan nilai umum untuk jenis antarmuka meskipun banyak nilai lain dimungkinkan.

dwMtu

Jenis: DWORD

Ukuran Unit Transmisi Maksimum (MTU) dalam byte.

dwSpeed

Jenis: DWORD

Kecepatan antarmuka dalam bit per detik.

dwPhysAddrLen

Jenis: DWORD

Panjangnya, dalam byte, dari alamat fisik yang ditentukan oleh anggota bPhysAddr .

bPhysAddr[MAXLEN_PHYSADDR]

Jenis: BYTE[MAXLEN_PHYSADDR]

Alamat fisik adapter untuk antarmuka ini.

dwAdminStatus

Jenis: DWORD

Antarmuka diaktifkan atau dinonaktifkan secara administratif.

dwOperStatus

Jenis: DWORD

Status operasional antarmuka. Anggota ini dapat menjadi salah satu nilai berikut yang ditentukan dalam enumerasi INTERNAL_IF_OPER_STATUS yang ditentukan dalam file header Ipifcons.h .

dwLastChange

Jenis: DWORD

Lamanya waktu, dalam seratus detik (10^-2 detik), mulai dari komputer terakhir dimulai ulang, ketika antarmuka memasuki status operasionalnya saat ini. Nilai ini bergulir setelah 2^32 per seratus detik.

Anggota dwLastChange saat ini tidak didukung oleh NDIS. Pada Windows Vista dan yang lebih baru, NDIS mengembalikan nol untuk anggota ini. Pada versi Windows yang lebih lama, nilai arbitrer dikembalikan dalam anggota ini untuk antarmuka yang didukung oleh NDIS. Untuk antarmuka yang didukung oleh penyedia antarmuka lain, antarmuka mungkin mengembalikan nilai yang sesuai.

dwInOctets

Jenis: DWORD

Jumlah oktet data yang diterima melalui antarmuka ini.

dwInUcastPkts

Jenis: DWORD

Jumlah paket unicast yang diterima melalui antarmuka ini.

dwInNUcastPkts

Jenis: DWORD

Jumlah paket non-unicast yang diterima melalui antarmuka ini. Paket siaran dan multicast disertakan.

dwInDiscards

Jenis: DWORD

Jumlah paket masuk yang dibuang meskipun tidak memiliki kesalahan.

dwInErrors

Jenis: DWORD

Jumlah paket masuk yang dibuang karena kesalahan.

dwInUnknownProtos

Jenis: DWORD

Jumlah paket masuk yang dibuang karena protokol tidak diketahui.

dwOutOctets

Jenis: DWORD

Jumlah oktet data yang dikirim melalui antarmuka ini.

dwOutUcastPkts

Jenis: DWORD

Jumlah paket unicast yang dikirim melalui antarmuka ini.

dwOutNUcastPkts

Jenis: DWORD

Jumlah paket non-unicast yang dikirim melalui antarmuka ini. Paket siaran dan multicast disertakan.

dwOutDiscards

Jenis: DWORD

Jumlah paket keluar yang dibuang meskipun tidak memiliki kesalahan.

dwOutErrors

Jenis: DWORD

Jumlah paket keluar yang dibuang karena kesalahan.

dwOutQLen

Jenis: DWORD

Panjang antrean transmisi. Bidang ini saat ini tidak digunakan.

dwDescrLen

Jenis: DWORD

Panjangnya, dalam byte, dari anggota bDescr .

bDescr[MAXLEN_IFDESCR]

Jenis: BYTE[MAXLEN_IFDESCR]

Deskripsi antarmuka.

Keterangan

Anggota dwSpeed dari struktur MIB_IFROW akan salah untuk antarmuka jaringan berkecepatan sangat tinggi (adaptor jaringan 10 Gbit/dtk, misalnya) karena nilai maksimum yang dapat disimpan dalam DWORD adalah 4.294.967.295. Aplikasi harus menggunakan struktur MIB_IF_ROW2 yang dikembalikan oleh fungsi GetIfEntry2 dan GetIfTable2 atau struktur IP_ADAPTER_ADDRESSES yang dikembalikan oleh fungsi GetAdaptersAddresses untuk menentukan kecepatan antarmuka jaringan berkecepatan sangat tinggi.

Pada Kit Pengembangan Perangkat Lunak (SDK) Microsoft Windows yang dirilis untuk Windows Vista dan yang lebih baru, organisasi file header telah berubah dan struktur MIB_IFROW didefinisikan dalam file header Ifmib.h tidak dalam file header Iprtrmib.h . Perhatikan bahwa file header Ifmib.h secara otomatis disertakan dalam Iprtrmib.h yang secara otomatis disertakan dalam file header Iphlpapi.h . File header Ifmib.h dan Iprtrmib.h tidak boleh digunakan secara langsung.

Persyaratan

Lihat juga

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0