struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES (ndis.h)

Artikel
08/07/2023

Struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES menentukan atribut adaptor jaringan yang dibantu perangkat keras.

Sintaks

typedef struct _NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_HD_SPLIT_ATTRIBUTES         HDSplitAttributes;
  PNDIS_RECEIVE_FILTER_CAPABILITIES HardwareReceiveFilterCapabilities;
  PNDIS_RECEIVE_FILTER_CAPABILITIES CurrentReceiveFilterCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     HardwareNicSwitchCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     CurrentNicSwitchCapabilities;
  PNDIS_SRIOV_CAPABILITIES          HardwareSriovCapabilities;
  PNDIS_SRIOV_CAPABILITIES          CurrentSriovCapabilities;
  PNDIS_QOS_CAPABILITIES            HardwareQosCapabilities;
  PNDIS_QOS_CAPABILITIES            CurrentQosCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    HardwareGftOffloadCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    CurrentGftOffloadCapabilities;
} NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . Driver mengatur anggota Jenis struktur yang ditentukan Header ke NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Untuk menunjukkan versi struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES , atur anggota Revisi ke salah satu nilai berikut:

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

Menambahkan berbagai anggota untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Menambahkan anggota HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilities, dan CurrentNicSwitchCapabilities untuk NDIS 6.20.

Atur anggota Ukuran ke NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

Versi asli untuk NDIS 6.1.

Atur anggota Ukuran ke NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1.

HDSplitAttributes

Penunjuk ke struktur NDIS_HD_SPLIT_ATTRIBUTES yang mewakili kemampuan pemisahan header-data yang disediakan adaptor jaringan. Jika adaptor jaringan tidak mendukung fitur pemisahan data header, atur HDSplitAttributes ke NULL.

HardwareReceiveFilterCapabilities

Penunjuk ke NDIS_RECEIVE_FILTER_CAPABILITIES struktur. Struktur ini menentukan kemampuan pemfilteran penerimaan perangkat keras adaptor jaringan. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung pemfilteran.

Peringatan Jika anggota ini tidak diatur ke NULL, anggota CurrentReceiveFilterCapabilities tidak boleh diatur ke NULL.

CurrentReceiveFilterCapabilities

Penunjuk ke struktur NDIS_RECEIVE_FILTER_CAPABILITIES. Struktur ini menentukan kemampuan pemfilteran terima yang saat ini diaktifkan pada adaptor jaringan. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung pemfilteran.

Peringatan Jika anggota ini tidak diatur ke NULL, anggota HardwareReceiveFilterCapabilities tidak boleh diatur ke NULL.

HardwareNicSwitchCapabilities

Penunjuk ke NDIS_NIC_SWITCH_CAPABILITIES struktur. Struktur ini menentukan kemampuan sakelar NIC perangkat keras adaptor jaringan. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung fitur sakelar NIC atau menerima pemfilteran.

Peringatan Jika anggota ini tidak diatur ke NULL, anggota CurrentNicSwitchCapabilities tidak boleh diatur ke NULL.

CurrentNicSwitchCapabilities

Penunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES . Struktur ini menentukan kemampuan sakelar NIC yang saat ini diaktifkan pada adaptor jaringan. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung fitur sakelar NIC atau menerima pemfilteran.

Peringatan Jika anggota ini tidak diatur ke NULL, anggota HardwareNicSwitchCapabilities tidak boleh diatur ke NULL.

HardwareSriovCapabilities

Penunjuk ke struktur NDIS_SRIOV_CAPABILITIES . Struktur ini menentukan kemampuan virtualisasi I/O root tunggal (SR-IOV) dari perangkat keras adaptor jaringan. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung SR-IOV.

Untuk informasi selengkapnya tentang SR-IOV, lihat Virtualisasi I/O Root Tunggal (SR-IOV).

Catatan Jika anggota ini tidak diatur ke NULL, anggota CurrentSriovCapabilities, HardwareNicSwitchCapabilities, dan CurrentNicSwitchCapabilities tidak boleh diatur ke NULL.

CurrentSriovCapabilities

Penunjuk ke struktur NDIS_SRIOV_CAPABILITIES . Struktur ini menentukan kemampuan SR-IOV yang saat ini diaktifkan pada adaptor jaringan. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung SR-IOV.

Catatan Jika anggota ini tidak diatur ke NULL, anggota HardwareSriovCapabilities, HardwareNicSwitchCapabilities, dan CurrentNicSwitchCapabilities tidak boleh diatur ke NULL.

HardwareQosCapabilities

Penunjuk ke struktur NDIS_QOS_CAPABILITIES . Struktur ini menentukan kemampuan perangkat keras yang didukung adaptor jaringan untuk kualitas layanan (QoS) NDIS melalui antarmuka IEEE 802.1 Data Center Bridging (DCB). Nilai ini bisa NULL jika adaptor jaringan tidak mendukung kemampuan perangkat keras QoS NDIS untuk DCB.

Untuk informasi selengkapnya, lihat NDIS QoS untuk Bridging Pusat Data.

Catatan Jika anggota ini tidak diatur ke NULL, anggota CurrentQosCapabilities tidak boleh diatur ke NULL.

CurrentQosCapabilities

Penunjuk ke struktur NDIS_QOS_CAPABILITIES . Struktur ini menentukan kemampuan perangkat keras yang saat ini diaktifkan pada adaptor jaringan untuk QoS NDIS melalui antarmuka DCB. Nilai ini bisa NULL jika adaptor jaringan tidak mendukung kemampuan perangkat keras QoS NDIS untuk DCB.

Jika adaptor mendukung kemampuan QoS NDIS tetapi kemampuan tersebut dinonaktifkan, driver miniport harus mengatur semua anggota struktur NDIS_QOS_CAPABILITIES (dengan pengecualian anggota Header ) ke nol.

Catatan Jika anggota ini tidak diatur ke NULL, anggota HardwareQosCapabilities tidak boleh diatur ke NULL.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Keterangan

Untuk mendaftarkan kemampuan yang dibantu perangkat keras dari adaptor jaringan yang mendasar, driver miniport memanggil Fungsi NdisMSetMiniportAttributes dari fungsi MiniportInitializeEx-nya . Driver meneruskan struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES yang diinisialisasi ke parameter MiniportAttributes dari fungsi ini.