struktur NDIS_FILTER_ATTACH_PARAMETERS (ndis.h)

Artikel
08/07/2023

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.

Catatan Dimulai dengan Windows Server 2012, Windows hanya mendukung sakelar NIC default yang dibuat pada adaptor miniport fungsi fisik (PF). Oleh karena itu, array ini hanya dapat berisi satu elemen.

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.