struktur NET_IF_INFORMATION (ndis.h)

Artikel
08/07/2023

Struktur NET_IF_INFORMATION memberi NDIS informasi tentang antarmuka jaringan terdaftar.

Sintaks

typedef struct _NET_IF_INFORMATION {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NET_PHYSICAL_LOCATION  PhysicalLocation;
  ULONG                  WanTunnelType;
  ULONG                  PortNumber;
  NET_IF_ACCESS_TYPE     AccessType;
  NET_IF_DIRECTION_TYPE  DirectionType;
  NET_IF_CONNECTION_TYPE ConnectionType;
  BOOLEAN                ifConnectorPresent;
  USHORT                 PhysAddressLength;
  USHORT                 PhysAddressOffset;
  USHORT                 PermanentPhysAddressOffset;
  USHORT                 FriendlyNameLength;
  USHORT                 FriendlyNameOffset;
  GUID                   InterfaceGuid;
  NET_IF_NETWORK_GUID    NetworkGuid;
  ULONG                  SupportedStatistics;
  NDIS_MEDIUM            MediaType;
  NDIS_PHYSICAL_MEDIUM   PhysicalMediumType;
} NET_IF_INFORMATION, *PNET_IF_INFORMATION;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur informasi antarmuka (NET_IF_INFORMATION). Penyedia mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_DEFAULT, anggota Revisi ke NDIS_OBJECT_REVISION_1, dan anggota Ukuran ke NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.

Flags

Bendera yang menyediakan informasi tentang antarmuka yang dijelaskan struktur ini. Bendera ini dikombinasikan dengan operasi OR bitwise. Jika tidak ada bendera yang berlaku, atur anggota ini ke nol. Nilai bendera berikut ditentukan:

NIIF_HARDWARE_INTERFACE

Atur apakah antarmuka jaringan adalah untuk perangkat keras.

NIIF_FILTER_INTERFACE

Atur apakah antarmuka jaringan adalah untuk modul filter.

NIIF_NDIS_RESERVED1

Dicadangkan untuk NDIS.

NIIF_NDIS_RESERVED2

Dicadangkan untuk NDIS.

NIIF_NDIS_RESERVED3

Dicadangkan untuk NDIS.

PhysicalLocation

Lokasi fisik untuk perangkat keras yang terkait dengan antarmuka yang ditentukan dalam NET_PHYSICAL_LOCATION struktur.

WanTunnelType

TunnelIfEncapsMethod (dari RFC 2667) untuk perangkat WAN. Jika jenis terowongan WAN tidak diketahui, atur anggota ini ke NIIF_WAN_TUNNEL_TYPE_UNKNOWN.

PortNumber

Nomor port NDIS untuk antarmuka.

AccessType

Jenis akses antarmuka jaringan NET_IF_ACCESS_TYPE NDIS.

DirectionType

Jenis arah antarmuka jaringan NET_IF_DIRECTION_TYPE NDIS.

ConnectionType

Jenis koneksi antarmuka jaringan NET_IF_CONNECTION_TYPE NDIS.

ifConnectorPresent

Nilai Boolean yang menunjukkan apakah konektor ada. Atur nilai ini ke TRUE jika ada adaptor fisik atau FALSE jika tidak ada adaptor fisik.

PhysAddressLength

Panjangnya, dalam byte, dari alamat fisik atau alamat MAC. Panjang ini adalah panjang array byte yang terletak di offset yang ditentukan oleh anggota PhysAddressOffset dan PermanentPhysAddressOffset .

PhysAddressOffset

Offset alamat fisik saat ini, dalam byte, dari awal struktur ini. Alamat fisik saat ini adalah array byte. Panjang array ditentukan dalam anggota PhysAddressLength . Alamat fisik saat ini adalah nilai yang sama dengan yang dikembalikan OID_802_3_CURRENT_ADDRESS OID.

PermanentPhysAddressOffset

Offset alamat fisik permanen, dalam byte, dari awal struktur ini. Alamat fisik permanen adalah array byte. Panjang array ditentukan dalam anggota PhysAddressLength . Alamat fisik permanen adalah nilai yang sama dengan yang dikembalikan OID_802_3_PERMANENT_ADDRESS OID.

FriendlyNameLength

Panjangnya, dalam byte, dari nama yang mudah diingat untuk antarmuka yang dijelaskan struktur ini. Panjang ini adalah panjang array WCHAR yang terletak di offset di anggota FriendlyNameOffset .

FriendlyNameOffset

Offset awal nama yang mudah diingat, dalam byte, dari awal struktur ini. Nama ini harus mencakup nama produsen, produk, dan versi perangkat keras dan perangkat lunak antarmuka. Nama ditentukan sebagai array nilai WCHAR. Anggota FriendlyNameLength menentukan panjang array.

InterfaceGuid

GUID yang terkait dengan antarmuka. Penyedia antarmuka menghasilkan GUID antarmuka untuk antarmuka. Penyedia dapat memanggil rutinitas ExUuidCreate untuk membuat GUID. GUID antarmuka harus dikaitkan dengan nilai NET_LUID yang ditetapkan ke antarmuka. Jika penyedia menyimpan informasi tentang antarmuka dalam penyimpanan persisten, penyedia harus menyimpan GUID dan menggunakan kembali GUID saat mendaftarkan ulang antarmuka setelah komputer dimulai ulang.

NetworkGuid

GUID yang terkait dengan jaringan tempat antarmuka berada. Jika penyedia antarmuka tidak dapat menyediakan GUID jaringan, ia dapat melewati GUID nol. Dalam hal ini, NDIS akan mendaftarkan antarmuka di jaringan default kompartemen utama.

SupportedStatistics

Statistik yang didukung antarmuka. Untuk informasi selengkapnya, lihat anggota SupportedStatistics dari NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES struktur .

MediaType

Jenis NdisMediumXxx yang didukung antarmuka. Untuk informasi selengkapnya, lihat NDIS_MEDIUM.

PhysicalMediumType

Jenis sedang fisik untuk antarmuka. Untuk informasi selengkapnya, lihat OID_GEN_PHYSICAL_MEDIUM

Keterangan

Penyedia antarmuka jaringan menginisialisasi struktur NET_IF_INFORMATION untuk memberi NDIS informasi tentang antarmuka terdaftar. Untuk mendaftarkan antarmuka, penyedia meneruskan pointer ke struktur NET_IF_INFORMATION ke Fungsi NdisIfRegisterInterface .

Penyedia antarmuka harus mengalokasikan memori yang cukup untuk struktur dan array yang ditentukan oleh anggota PhysAddressOffset, PermanentPhysAddressOffset, dan FriendlyNameOffset . Penyedia harus menyediakan nilai untuk array setelah struktur dan mengatur anggota offset untuk mengidentifikasi lokasi array.