struktur NDIS_BIND_PARAMETERS (ndis.h)
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.
Keterangan
NDIS meneruskan pointer ke struktur NDIS_BIND_PARAMETERS dalam parameter BindParameters Fungsi ProtocolBindAdapterEx .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Didukung di NDIS 6.0 dan yang lebih baru. |
Header | ndis.h (termasuk Ndis.h) |
Lihat juga
NDIS_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIES