struktur NDIS_BIND_PARAMETERS (ndis.h)

Artikel
04/13/2023

NDIS menginisialisasi struktur NDIS_BIND_PARAMETERS dengan informasi yang menentukan karakteristik pengikatan dan meneruskannya ke driver protokol.

Sintaks

typedef struct _NDIS_BIND_PARAMETERS {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_STRING                      ProtocolSection;
  PNDIS_STRING                      AdapterName;
  PDEVICE_OBJECT                    PhysicalDeviceObject;
  NDIS_MEDIUM                       MediaType;
  ULONG                             MtuSize;
  ULONG64                           MaxXmitLinkSpeed;
  ULONG64                           XmitLinkSpeed;
  ULONG64                           MaxRcvLinkSpeed;
  ULONG64                           RcvLinkSpeed;
  NDIS_MEDIA_CONNECT_STATE          MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE           MediaDuplexState;
  ULONG                             LookaheadSize;
  PNDIS_PNP_CAPABILITIES            PowerManagementCapabilities;
  ULONG                             SupportedPacketFilters;
  ULONG                             MaxMulticastListSize;
  USHORT                            MacAddressLength;
  UCHAR                             CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_PHYSICAL_MEDIUM              PhysicalMediumType;
  PNDIS_RECEIVE_SCALE_CAPABILITIES  RcvScaleCapabilities;
  NET_LUID                          BoundIfNetluid;
  NET_IFINDEX                       BoundIfIndex;
  NET_LUID                          LowestIfNetluid;
  NET_IFINDEX                       LowestIfIndex;
  NET_IF_ACCESS_TYPE                AccessType;
  NET_IF_DIRECTION_TYPE             DirectionType;
  NET_IF_CONNECTION_TYPE            ConnectionType;
  NET_IFTYPE                        IfType;
  BOOLEAN                           IfConnectorPresent;
  PNDIS_PORT                        ActivePorts;
  ULONG                             DataBackFillSize;
  ULONG                             ContextBackFillSize;
  ULONG                             MacOptions;
  NET_IF_COMPARTMENT_ID             CompartmentId;
  PNDIS_OFFLOAD                     DefaultOffloadConfiguration;
  PNDIS_TCP_CONNECTION_OFFLOAD      TcpConnectionOffloadCapabilities;
  PNDIS_STRING                      BoundAdapterName;
  PNDIS_HD_SPLIT_CURRENT_CONFIG     HDSplitCurrentConfig;
  PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
  PNDIS_PM_CAPABILITIES             PowerManagementCapabilitiesEx;
  PNDIS_NIC_SWITCH_CAPABILITIES     NicSwitchCapabilities;
  BOOLEAN                           NDKEnabled;
  PNDIS_NDK_CAPABILITIES            NDKCapabilities;
  PNDIS_SRIOV_CAPABILITIES          SriovCapabilities;
  PNDIS_NIC_SWITCH_INFO_ARRAY       NicSwitchArray;
} NDIS_BIND_PARAMETERS, *PNDIS_BIND_PARAMETERS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_BIND_PARAMETERS . NDIS mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_BIND_PARAMETERS.

Untuk menunjukkan versi struktur NDIS_BIND_PARAMETERS, NDIS mengatur anggota Revisi ke salah satu nilai berikut:

NDIS_BIND_PARAMETERS_REVISION_4

Menambahkan berbagai anggota untuk NDIS 6.30.

NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4.

NDIS_BIND_PARAMETERS_REVISION_3

Menambahkan anggota ReceiveFilterCapabilities, PowerManagementCapabilitiesEx, dan NicSwitchCapabilities untuk NDIS 6.20.

NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3.

NDIS_BIND_PARAMETERS_REVISION_2

Menambahkan anggota HDSplitCurrentConfig untuk NDIS 6.1.

NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2.

NDIS_BIND_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.0.

NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1.

ProtocolSection

Penunjuk ke string Unicode yang berisi jalur registri. Jalur dimulai dari kunci layanan driver protokol dan melanjutkan hierarki registri ke nama adaptor miniport (misalnya, Tcpip\Parameters\Adapters\<miniport adapter name>). Nama adaptor miniport adalah nama adaptor miniport paling bawah di tumpukan driver. Jika ada driver perantara MUX di tumpukan, adaptor miniport paling bawah adalah miniport virtual. Jika tidak, adaptor miniport paling bawah adalah adaptor miniport untuk perangkat fisik.

Driver protokol dapat menggunakan jalur registri ini untuk membaca parameter konfigurasi yang khusus untuk pengikatan antara driver dan adaptor miniport yang mendasar.

AdapterName

Penunjuk ke string Unicode yang berisi nama adaptor miniport yang mendasar yang harus diikat ProtocolBindAdapterEx .

PhysicalDeviceObject

Objek perangkat fisik untuk adaptor miniport yang mendasar.

MediaType

Jenis NdisMediumXxx yang didukung adaptor miniport yang mendasar. Untuk informasi selengkapnya tentang jenis NdisMediumXxx , lihat NDIS_MEDIUM.

MtuSize

Ukuran unit transfer maksimum (MTU). Untuk informasi selengkapnya, lihat OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Kecepatan tautan transmisi maksimum adaptor yang mendasarinya dalam bit per detik. Untuk informasi selengkapnya, lihat OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

Kecepatan tautan transmisi saat ini dari adaptor yang mendasarinya dalam bit per detik. Untuk informasi selengkapnya, lihat OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

Kecepatan tautan penerima maksimum adaptor yang mendasarinya dalam bit per detik. Untuk informasi selengkapnya, lihat OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

Kecepatan tautan penerima saat ini dari adaptor yang mendasarinya dalam bit per detik. Untuk informasi selengkapnya, lihat OID_GEN_LINK_SPEED_EX.

MediaConnectState

Status sambungan media untuk adaptor miniport yang mendasar. Untuk mengetahui informasi selengkapnya, lihat OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

Status dupleks media untuk adaptor miniport yang mendasar. Untuk informasi selengkapnya, lihat OID_GEN_MEDIA_DUPLEX_STATE.

LookaheadSize

Ukuran lookahead untuk adaptor miniport yang mendasar. Untuk informasi selengkapnya, lihat OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Kemampuan Plug and Play adaptor miniport yang mendasar. Untuk informasi selengkapnya, lihat OID_PNP_CAPABILITIES. Driver NDIS 6.20 dan yang lebih baru harus menggunakan anggota PowerManagementCapabilitiesEx sebagai gantinya.

SupportedPacketFilters

Sekumpulan bendera yang mengidentifikasi jenis paket jaringan yang dapat difilter oleh adaptor miniport yang mendasar.

MaxMulticastListSize

Ukuran daftar alamat multicast untuk adaptor miniport yang mendasar. Untuk mengetahui informasi selengkapnya, lihat OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

Panjang alamat MAC, dalam byte. Panjang alamat MAC khusus untuk jenis media.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Alamat MAC saat ini. Misalnya, OID_802_3_CURRENT_ADDRESS OID menentukan alamat MAC saat ini untuk driver IEEE 802.3.

PhysicalMediumType

Jenis sedang fisik untuk adaptor miniport. Untuk informasi selengkapnya, lihat OID_GEN_PHYSICAL_MEDIUM.

RcvScaleCapabilities

Kemampuan receive side scaling (RSS) NIC. Untuk mengetahui informasi selengkapnya, lihat OID_GEN_RECEIVE_SCALE_CAPABILITIES.

BoundIfNetluid

Nilai NET_LUID NDIS, yang juga merupakan nama antarmuka jaringan ( ifName di RFC 2863), dari antarmuka tingkat tertinggi yang ditumpuk pada adaptor miniport. Artinya, jika ada miniport virtual atau modul filter yang diinstal melalui adaptor miniport, ini adalah nilai NET_LUID dari tingkat tertinggi miniport virtual atau modul filter.

BoundIfIndex

Indeks antarmuka jaringan NDIS dari antarmuka tingkat tertinggi yang ditumpuk pada adaptor miniport. Artinya, jika ada miniport virtual atau modul filter yang diinstal melalui adaptor miniport, ini adalah ifIndex dari tingkat tertinggi miniport virtual atau modul filter.

LowestIfNetluid

Nilai NET_LUID NDIS, yang juga merupakan nama antarmuka jaringan ( ifName di RFC 2863), dari antarmuka tingkat terendah pada pengikatan. Artinya, antarmuka jaringan NDIS dari adaptor miniport di bagian bawah tumpukan filter.

LowestIfIndex

Indeks antarmuka jaringan NDIS dari antarmuka tingkat terendah pada pengikatan. Artinya, antarmuka jaringan NDIS dari adaptor miniport di bagian bawah tumpukan filter.

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 NDIS. Gunakan NET_IF_CONNECTION_DEDICATED untuk adaptor Ethernet yang khas. Nilai berikut valid:

NET_IF_CONNECTION_DEDICATED

Menentukan jenis koneksi khusus. Koneksi muncul secara otomatis ketika pengertian media TRUE. Misalnya, koneksi Ethernet didedikasikan.

NET_IF_CONNECTION_PASSIVE

Menentukan jenis koneksi pasif. Ujung lainnya harus memunculkan koneksi ke stasiun lokal. Misalnya, antarmuka RAS pasif.

NET_IF_CONNECTION_DEMAND

Menentukan tipe sambungan putar-nomor permintaan. Koneksi putar-nomor permintaan muncul sebagai respons terhadap tindakan lokal--misalnya, mengirim paket.

IfType

Jenis antarmuka Internet Assigned Numbers Authority (IANA). Misalnya, IF_TYPE_ETHERNET_CSMACD (6) adalah nilai untuk IfType yang ditetapkan ke antarmuka seperti Ethernet. Untuk daftar jika jenis antarmuka, lihat Jenis Antarmuka NDIS.

IfConnectorPresent

Nilai Boolean yang menunjukkan apakah konektor ada. NDIS menetapkan nilai ini ke TRUE jika ada adaptor fisik.

ActivePorts

Untuk ditentukan.

DataBackFillSize

Ukuran isi ulang data yang diperlukan, dalam byte, dari tumpukan driver yang mendasar.

ContextBackFillSize

Ukuran isi ulang konteks yang diperlukan, dalam byte, dari tumpukan driver yang mendasar.

MacOptions

Opsi MAC untuk adaptor miniport. Untuk informasi selengkapnya, lihat OID_GEN_MAC_OPTIONS.

CompartmentId

Kompartemen tempat antarmuka yang mendasar berada atau salah satu nilai berikut:

NET_IF_COMPARTMENT_ID_UNSPECIFIED

Menentukan bahwa pengidentifikasi kompartemen tidak digunakan atau ditentukan.

NET_IF_COMPARTMENT_ID_PRIMARY

Menentukan pengidentifikasi kompartemen default. Penyedia antarmuka pihak ketiga harus selalu menentukan NET_IF_COMPARTMENT_ID_PRIMARY. Semua nilai lainnya dicadangkan untuk penggunaan internal Microsoft.

DefaultOffloadConfiguration

Penunjuk ke struktur NDIS_OFFLOAD . Struktur ini menentukan kemampuan untuk adaptor miniport berkemampu offload tugas. Untuk mengetahui informasi selengkapnya, lihat OID_TCP_OFFLOAD_CURRENT_CONFIG.

TcpConnectionOffloadCapabilities

Penunjuk ke NDIS_TCP_CONNECTION_OFFLOAD struktur yang menunjukkan kemampuan offload saat ini yang disediakan oleh adaptor miniport yang mendasar.

BoundAdapterName

Penunjuk ke string Unicode yang berisi nama adaptor miniport tingkat tertinggi yang ditumpuk pada adaptor miniport yang mendasar. Artinya, jika ada miniport virtual driver perantara filter yang dipasang melalui adaptor miniport, anggota ini adalah nama miniport virtual driver perantara filter tingkat tertinggi.

HDSplitCurrentConfig

Penunjuk ke NDIS_HD_SPLIT_CURRENT_CONFIG struktur. Struktur ini menentukan konfigurasi pemisahan header-data saat ini dari adaptor miniport yang mendasar. Nilai ini bisa null jika adaptor miniport tidak mendukung pemisahan header-data.

ReceiveFilterCapabilities

Penunjuk ke NDIS_RECEIVE_FILTER_CAPABILITIES struktur. Struktur ini menentukan kemampuan pemfilteran generik yang saat ini diaktifkan pada adaptor miniport yang mendasar. Nilai ini bisa NULL jika adaptor miniport tidak mendukung pemfilteran penerimaan.

PowerManagementCapabilitiesEx

Penunjuk ke struktur NDIS_PM_CAPABILITIES . Struktur ini menentukan kemampuan manajemen daya adaptor miniport. Anggota ini wajib untuk driver NDIS 6.20 dan yang lebih baru.

NicSwitchCapabilities

Penunjuk ke NDIS_NIC_SWITCH_CAPABILITIES struktur. Struktur ini menentukan kemampuan sakelar NIC dari adaptor miniport yang mendasar. Nilai ini bisa NULL jika adaptor miniport tidak mendukung fitur sakelar NIC.

NDKEnabled

NDIS menetapkan nilai ini ke TRUE jika antarmuka penyedia kernel langsung jaringan (NDKPI) saat ini diaktifkan pada adaptor miniport yang mendasar.

NDKCapabilities

Penunjuk ke struktur NDIS_NDK_CAPABILITIES . Struktur ini menentukan kemampuan NDKPI yang saat ini diaktifkan pada adaptor miniport yang mendasar. Nilai ini bisa null jika adaptor miniport tidak mendukung NDKPI.

SriovCapabilities

Penunjuk ke struktur NDIS_SRIOV_CAPABILITIES . Struktur ini menentukan kemampuan virtualisasi I/O root tunggal (SR-IOV) yang saat ini diaktifkan pada adaptor miniport yang mendasar. Nilai ini bisa null jika adaptor miniport tidak mendukung fitur SR-IOV.

NicSwitchArray

Penunjuk ke struktur NDIS_NIC_SWITCH_INFO_ARRAY . Array ini menghitung sakelar NIC yang telah dibuat pada adaptor miniport. Sakelar NIC hanya dapat dibuat jika SR-IOV didukung dan diaktifkan pada adaptor.

Catatan Dimulai dengan Windows Server 2012, Windows hanya mendukung sakelar NIC default pada adaptor miniport. Oleh karena itu, array ini hanya dapat berisi satu elemen.