struktur NDIS_FILTER_ATTACH_PARAMETERS (ndis.h)
Struktur NDIS_FILTER_ATTACH_PARAMETERS menentukan parameter inisialisasi untuk modul filter.
Sintaks
typedef struct _NDIS_FILTER_ATTACH_PARAMETERS {
NDIS_OBJECT_HEADER Header;
NET_IFINDEX IfIndex;
NET_LUID NetLuid;
PNDIS_STRING FilterModuleGuidName;
NET_IFINDEX BaseMiniportIfIndex;
PNDIS_STRING BaseMiniportInstanceName;
PNDIS_STRING BaseMiniportName;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_MEDIUM MiniportMediaType;
NDIS_PHYSICAL_MEDIUM MiniportPhysicalMediaType;
NDIS_HANDLE MiniportMediaSpecificAttributes;
PNDIS_OFFLOAD DefaultOffloadConfiguration;
USHORT MacAddressLength;
UCHAR CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
NET_LUID BaseMiniportNetLuid;
NET_IFINDEX LowerIfIndex;
NET_LUID LowerIfNetLuid;
ULONG Flags;
PNDIS_HD_SPLIT_CURRENT_CONFIG HDSplitCurrentConfig;
PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
PDEVICE_OBJECT MiniportPhysicalDeviceObject;
PNDIS_NIC_SWITCH_CAPABILITIES NicSwitchCapabilities;
BOOLEAN BaseMiniportIfConnectorPresent;
PNDIS_SRIOV_CAPABILITIES SriovCapabilities;
PNDIS_NIC_SWITCH_INFO_ARRAY NicSwitchArray;
} NDIS_FILTER_ATTACH_PARAMETERS, *PNDIS_FILTER_ATTACH_PARAMETERS;
Anggota
Header
Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_FILTER_ATTACH_PARAMETERS . NDIS mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_FILTER_ATTACH_PARAMETERS.
Untuk menunjukkan versi struktur NDIS_FILTER_ATTACH_PARAMETERS , NDIS mengatur anggota Revisi ke salah satu nilai berikut:
NDIS_FILTER_ATTACH__PARAMETERS_REVISION_4
Menambahkan berbagai anggota untuk NDIS 6.30.
NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_4.
NDIS_FILTER_ATTACH_PARAMETERS_REVISION_3
Menambahkan anggota ReceiveFilterCapabilities, MiniportPhysicalDeviceObject, dan NicSwitchCapabilities untuk NDIS 6.20.
NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_3.
NDIS_FILTER_ATTACH_PARAMETERS_REVISION_2
Menambahkan anggota HDSplitCurrentConfig untuk NDIS 6.1.
NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_2.
NDIS_FILTER_ATTACH_PARAMETERS_REVISION_1
Versi asli untuk NDIS 6.0.
NDIS mengatur anggota Ukuran ke NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_1.
IfIndex
Indeks antarmuka NDIS dari modul filter yang dilampirkan NDIS ke tumpukan driver.
NetLuid
Nilai NET_LUID antarmuka jaringan NDIS untuk modul filter yang dilampirkan NDIS ke tumpukan driver. NET_LUID setara dengan nama antarmuka (ifName di RFC 2863 ).
FilterModuleGuidName
Nama GUID modul filter yang dilampirkan NDIS.
BaseMiniportIfIndex
Indeks antarmuka jaringan NDIS dari adaptor miniport dasar. Artinya, jika ada miniport virtual atau modul filter yang dipasang melalui adaptor miniport fisik, nilai anggota ini adalah indeks antarmuka adaptor miniport fisik atau miniport virtual driver perantara MUX tingkat tertinggi.
BaseMiniportInstanceName
Penunjuk ke nilai jenis NDIS_STRING yang berisi string Unicode yang dihitung. String ini menentukan nama antarmuka yang mudah diingat untuk adaptor miniport dasar. Untuk Windows 2000 dan versi yang lebih baru, NDIS menentukan jenis NDIS_STRING sebagai jenis UNICODE_STRING .
BaseMiniportName
Nama adaptor miniport dasar.
MediaConnectState
The NET_IF_MEDIA_CONNECT_STATE tipe status koneksi.
MediaDuplexState
Status dupleks media untuk adaptor miniport yang mendasar. Untuk informasi selengkapnya, lihat OID_GEN_MEDIA_DUPLEX_STATE.
XmitLinkSpeed
Kecepatan tautan transmisi saat ini dari adaptor miniport yang mendasarinya dalam bit per detik. Untuk informasi selengkapnya, lihat OID_GEN_LINK_SPEED_EX.
RcvLinkSpeed
Kecepatan tautan penerima saat ini dari adaptor miniport yang mendasarinya dalam bit per detik. Untuk informasi selengkapnya, lihat OID_GEN_LINK_SPEED_EX.
MiniportMediaType
Jenis NdisMediumXxx yang didukung adaptor miniport dasar. Untuk informasi selengkapnya, lihat NDIS_MEDIUM.
MiniportPhysicalMediaType
Jenis sedang fisik untuk adaptor miniport dasar yang mendasar. Untuk informasi selengkapnya, lihat OID_GEN_PHYSICAL_MEDIUM.
MiniportMediaSpecificAttributes
Penunjuk ke struktur NDIS_OBJECT_HEADER yang mengidentifikasi struktur yang berisi atribut khusus media miniport, atau NULL jika tidak ada atribut tersebut. Anggota jenis struktur NDIS_OBJECT_HEADER mengidentifikasi jenis struktur atribut. Misalnya, jika jenis media adaptor miniport yang mendasar NdisMediumNative802_11, maka anggota Jenis harus NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES, dan anggota MiniportMediaSpecificAttributes menunjuk ke anggota MiniportMediaSpecificAttributes NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES struktur.
DefaultOffloadConfiguration
Penunjuk ke struktur NDIS_OFFLOAD yang menentukan atribut offload tugas. Driver filter harus meninjau atribut ini untuk mendapatkan kemampuan offload tugas dari driver yang mendasar. Driver filter harus memodifikasi atribut ini, jika perlu, untuk mencerminkan perubahan apa pun dalam dukungan offload tugas yang diperlukan.
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.
BaseMiniportNetLuid
Antarmuka jaringan NDIS NET_LUID adaptor miniport dasar. Artinya, jika ada miniport virtual atau modul filter yang dipasang melalui adaptor miniport fisik, nilai anggota ini adalah NET_LUID adaptor miniport fisik atau miniport virtual dari driver perantara MUX tingkat tertinggi.
LowerIfIndex
Indeks antarmuka jaringan NDIS antarmuka tepat di bawah modul filter saat ini. Artinya, jika ada modul filter atau NDIS 5. x memfilter driver perantara yang dipasang melalui adaptor miniport fisik atau driver perantara MUX tingkat tertinggi, anggota ini berisi indeks antarmuka antarmuka modul filter atau antarmuka driver perantara filter yang tepat di bawah modul filter saat ini. Jika tidak ada modul filter atau antarmuka driver perantara filter yang diinstal melalui adaptor miniport fisik atau driver perantara MUX tingkat tertinggi, anggota ini berisi indeks antarmuka adaptor miniport fisik yang mendasar atau miniport virtual driver menengah MUX tingkat tertinggi.
LowerIfNetLuid
Antarmuka jaringan NDIS NET_LUID nilai antarmuka tepat di bawah modul filter saat ini. Artinya, jika ada modul filter atau NDIS 5. x memfilter driver perantara yang dipasang melalui adaptor miniport fisik atau driver perantara MUX tingkat tertinggi, anggota ini berisi antarmuka jaringan NET_LUID antarmuka modul filter atau antarmuka driver perantara filter yang tepat di bawah modul filter saat ini. Jika tidak ada modul filter atau antarmuka driver perantara filter yang diinstal melalui adaptor miniport fisik atau driver perantara MUX tingkat tertinggi, anggota ini berisi antarmuka jaringan NET_LUID adaptor miniport fisik yang mendasar atau miniport virtual driver perantara MUX tingkat tertinggi.
Flags
Disiapkan untuk penggunaan masa mendatang.
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.
MiniportPhysicalDeviceObject
Penunjuk ke struktur DEVICE_OBJECT . Struktur ini mewakili perangkat fisik untuk adaptor miniport yang mendasar.
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.
BaseMiniportIfConnectorPresent
Nilai Boolean yang, jika diatur ke TRUE, menunjukkan apakah konektor antarmuka jaringan (jika) ada pada adaptor jaringan yang mendasar. Nilai ini harus diatur ke TRUE untuk adaptor fisik.
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.
Untuk informasi selengkapnya, lihat Virtualisasi I/O Akar Tunggal (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
Untuk menentukan parameter lampirkan modul filter, NDIS meneruskan penunjuk ke struktur NDIS_FILTER_ATTACH_PARAMETERS ke fungsi FilterAttach .
Driver filter harus menghindari penerbitan kueri OID yang tidak perlu. Sebagai gantinya, gunakan informasi dalam NDIS_FILTER_ATTACH_PARAMETERS, jika tersedia, untuk mendapatkan informasi tentang driver yang mendasar.
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_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES NDIS_RECEIVE_FILTER_CAPABILITIESSaran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk