struktur NDIS_OFFLOAD_PARAMETERS (ntddndis.h)
Struktur NDIS_OFFLOAD_PARAMETERS menentukan pengaturan konfigurasi offload tugas saat ini sebagai respons terhadap permintaan set OID_TCP_OFFLOAD_PARAMETERS OID.
Sintaks
typedef struct _NDIS_OFFLOAD_PARAMETERS {
NDIS_OBJECT_HEADER Header;
UCHAR IPv4Checksum;
UCHAR TCPIPv4Checksum;
UCHAR UDPIPv4Checksum;
UCHAR TCPIPv6Checksum;
UCHAR UDPIPv6Checksum;
UCHAR LsoV1;
UCHAR IPsecV1;
UCHAR LsoV2IPv4;
UCHAR LsoV2IPv6;
UCHAR TcpConnectionIPv4;
UCHAR TcpConnectionIPv6;
ULONG Flags;
UCHAR IPsecV2;
UCHAR IPsecV2IPv4;
struct {
UCHAR RscIPv4;
UCHAR RscIPv6;
};
struct {
UCHAR EncapsulatedPacketTaskOffload;
UCHAR EncapsulationTypes;
};
union {
struct {
USHORT VxlanUDPPortNumber;
} VxlanParameters;
ULONG Value;
} EncapsulationProtocolParameters;
_ENCAPSULATION_PROTOCOL_PARAMETERS _ENCAPSULATION_PROTOCOL_PARAMETERS;
struct {
UCHAR IPv4;
UCHAR IPv6;
} UdpSegmentation;
struct {
UCHAR Enabled;
} UdpRsc;
} NDIS_OFFLOAD_PARAMETERS, *PNDIS_OFFLOAD_PARAMETERS;
Anggota
Header
Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_OFFLOAD_PARAMETERS . Atur anggota Jenis struktur yang ditentukan Header ke NDIS_OBJECT_TYPE_DEFAULT.
Untuk menunjukkan versi struktur NDIS_OFFLOAD_PARAMETERS , atur anggota Revisi ke salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_REVISION_6 6 |
Mendukung anggota UdpRsc untuk NDIS 6.89. Atur anggota Ukuran ke NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_6. |
| NDIS_OFFLOAD_PARAMETERS_REVISION_5 5 |
Mendukung UdpSegmentation untuk IPv4 dan IPv6 untuk NDIS 6.83. Atur anggota Ukuran ke NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_5. |
| NDIS_OFFLOAD_PARAMETERS_REVISION_4 4 |
Mendukung EncapsulationProtocolParameters dan VxlanParameters berlapis untuk NDIS 6.50. Atur anggota Ukuran ke NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_4. |
| NDIS_OFFLOAD_PARAMETERS_REVISION_3 3 |
Mendukung anggota RscIPv4, RscIPv6, EncapsulatedPacketTaskOffload, dan EncapsulationTypes untuk NDIS 6.30. Atur anggota Ukuran ke NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_3. |
| NDIS_OFFLOAD_PARAMETERS_REVISION_2 2 |
Mendukung anggota IPsecV2, IPsecV2IPv4, Reserved1, dan Reserved2 untuk NDIS 6.1. Atur anggota Ukuran ke NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_2. |
| NDIS_OFFLOAD_PARAMETERS_REVISION_1 1 |
Versi asli untuk NDIS 6.0. Atur anggota Ukuran ke NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_1. |
IPv4Checksum
Pengaturan checksum IPv4 dari adaptor miniport. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
TCPIPv4Checksum
Pengaturan checksum IPv4 adaptor miniport untuk paket TCP. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
UDPIPv4Checksum
Pengaturan checksum IPv4 dari adaptor miniport untuk paket UDP. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
TCPIPv6Checksum
Pengaturan checksum IPv6 dari adaptor miniport untuk paket TCP. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
UDPIPv6Checksum
Pengaturan checksum IPv6 dari adaptor miniport untuk paket UDP. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
LsoV1
Pengaturan offload pengiriman besar versi 1 (LSOV1) dari adaptor miniport. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_LSOV1_DISABLED | LSOV1 dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_LSOV1_ENABLED | LSOV1 diaktifkan. |
IPsecV1
Pengaturan offload keamanan protokol Internet (IPsec) dari adaptor miniport. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV1_DISABLED | Offload IPsec dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_ENABLED | Fitur IPsec offload Authentication Header (AH) harus diaktifkan untuk pengiriman dan penerimaan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV1_ESP_ENABLED | Fitur IPsec offload Encapsulating Security Payload (ESP) harus diaktifkan untuk pengiriman dan penerimaan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_AND_ESP_ENABLED | Fitur OFFLOAD IPsec AH dan ESP diaktifkan untuk transmisi dan penerimaan. |
LsoV2IPv4
Pengaturan offload pengiriman besar IPv4 versi 2 (LSOV2) dari adaptor miniport. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED | LSOV2 untuk IPv4 dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED | LSOV2 untuk IPv4 diaktifkan. |
LsoV2IPv6
Pengaturan IPv6 LSOV2 dari adaptor miniport. Pengaturan ini ditentukan sebagai salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED | LSOV2 untuk IPv6 dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED | LSOV2 untuk IPv6 diaktifkan. |
TcpConnectionIPv4
Pengaturan offload koneksi IPv4 dari adaptor miniport. Pengaturan ini ditentukan sebagai salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
TcpConnectionIPv6
Pengaturan offload koneksi IPv6 dari adaptor miniport. Pengaturan ini ditentukan sebagai salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
Flags
Sekumpulan bendera yang dapat dikombinasikan dengan operasi OR bitwise. Atur anggota ini ke nol atau nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_SKIP_REGISTRY_UPDATE 0x00000001 |
Memungkinkan UDP Receive Segment Coalescing Offload (URO) dinonaktifkan hanya saat runtime. Perubahan yang dibuat dengan bendera ini tidak disimpan ke registri. |
IPsecV2
Pengaturan offload keamanan protokol Internet (IPsec) versi 2 dari adaptor miniport yang mendukung IPv6 dan IPv4. Anggota ini menentukan pengaturan untuk dukungan IPv6 dan IPv4. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED | Offload IPsec versi 2 dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED | Fitur IPsec offload header autentikasi versi 2 (AH) harus diaktifkan untuk pengiriman dan penerimaan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED | Fitur Offload IPsec versi 2 Encapsulating Security Payload (ESP) harus diaktifkan untuk pengiriman dan penerimaan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED | Fitur offload IPsec versi 2 AH dan ESP diaktifkan untuk transmisi dan penerimaan. |
IPsecV2IPv4
Pengaturan offload keamanan protokol Internet (IPsec) versi 2 dari adaptor miniport yang mendukung IPv4 dan tidak mendukung IPv6. Jika driver miniport mendukung IPv6, anggota IPsecV2 menentukan pengaturan IPv4 dan anggota ini tidak digunakan. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah pengaturan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED | Offload IPsec versi 2 dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED | Fitur IPsec offload header autentikasi versi 2 (AH) harus diaktifkan untuk pengiriman dan penerimaan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED | Fitur Offload IPsec versi 2 Encapsulating Security Payload (ESP) harus diaktifkan untuk pengiriman dan penerimaan. |
| NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED | Fitur offload IPsec versi 2 AH dan ESP diaktifkan untuk transmisi dan penerimaan. |
RscIPv4
Menunjukkan status Menerima Coalescing Segmen untuk IPv4.
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Status RSC tidak berubah. |
| NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED | Status RSC diaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED | Status RSC dinonaktifkan. |
RscIPv6
Menunjukkan status Menerima Coalescing Segmen untuk IPv6.
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Status RSC tidak berubah. |
| NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED | Status RSC diaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED | Status RSC dinonaktifkan. |
EncapsulatedPacketTaskOffload
Driver protokol menetapkan EncapsulatedPacketTaskOffload sebagai berikut:
Catatan: Untuk menerima offload samping seperti VMQ dan RSS, ada OID lain yang dikirim driver protokol untuk mengaktifkan dan mengonfigurasi parameter offload (misalnya, antrean, hash, dan tabel tidak langsung). Anggota EncapsulatedPacketTaskOffload adalah tambahan untuk OID tersebut dan menginstruksikan NIC untuk juga melakukan offload ini untuk paket enkapsultasi.
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_SET_NO_CHANGE 0 |
Status offload tugas NVGRE dan VXLAN tidak berubah. |
| NDIS_OFFLOAD_SET_ON 1 |
Mengaktifkan offload tugas NVGRE dan VXLAN. |
| NDIS_OFFLOAD_SET_OFF 2 |
Menonaktifkan offload tugas NVGRE dan VXLAN. |
EncapsulationTypes
Bidang ini hanya efektif ketika EncapsulatedPacketTaskOffload diatur ke NDIS_OFFLOAD_SET_ON. Jika anggota EncapsulatedPacketTaskOffload tidak diatur ke NDIS_OFFLOAD_SET_ON, anggota ini adalah nol. Driver protokol harus mengatur EncapsulationTypes ke bitwise ATAU bendera yang sesuai dengan jenis enkapsulasi yang diperlukan. Ini dapat memilih bendera dari yang berikut ini:
| Nilai | Makna |
|---|---|
| NDIS_ENCAPSULATION_TYPE_GRE_MAC 0x00000001 |
Menentukan enkaplasi GRE MAC (NVGRE). |
| NDIS_ENCAPSULATION_TYPE_VXLAN 0x00000002 |
Menentukan enkaplasi VXLAN. |
EncapsulationProtocolParameters
Serikat yang menjelaskan parameter enkapulasi untuk enkaplasi VXLAN.
Jika driver miniport mengiklankan VxlanUDPPortNumerConfigurable sebagai TRUE, maka driver protokol dapat mengatur EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber ke nilai non-0. Driver miniport harus menggunakan nomor port ini untuk mencocokkan dan menghasilkan bingkai VXLAN setelah berhasil OID, dan juga mengiklankan nilai yang diperbarui dalam kemampuannya. Jika driver protokol melewati nilai 0, maka driver miniport terus menggunakan nomor port yang diinisialisasi dari kata kunci standar.
EncapsulationProtocolParameters.VxlanParameters
Struktur yang berisi VxlanUDPPortNumber.
EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber
Nilai port tujuan VXLAN. Nilai ini diatur ke nilai yang ditetapkan IANA sebesar 4789 secara default. Jika driver miniport mendukung nomor port yang dapat dikonfigurasi seperti yang diiklankan dalam struktur NDIS_OFFLOAD , driver protokol dapat mengeluarkan OID OID_TCP_OFFLOAD_PARAMETERS untuk mengaktifkan NDIS_ENCAPSULATION_TYPE_VXLAN dengan nilai yang berbeda di VxlanUDPPortNumber. Driver miniport harus menggunakan VxlanUDPPortNumber untuk menentukan paket enkapsulasi VXLAN untuk melakukan offload penerima.
EncapsulationProtocolParameters.Value
Nilai port jika EncapsulationTypes tidak diatur ke NDIS_ENCAPSULATION_TYPE_VXLAN.
_ENCAPSULATION_PROTOCOL_PARAMETERS
Nama jenis untuk EncapsulationProtocolParameters.
UdpSegmentation
Struktur yang menjelaskan pengaturan UDP Segmentation Offload (USO) adaptor miniport.
UdpSegmentation.IPv4
Pengaturan IPv4 UDP Segmentation Offload (USO) dari adaptor miniport. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah setelan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_UDP_SEG_DISABLED | USO dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_UDP_SEG_ENABLED | USO diaktifkan. |
UdpSegmentation.IPv6
Pengaturan IPv6 UDP Segmentation Offload (USO) adaptor miniport. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_NO_CHANGE | Pengandar miniport tidak boleh mengubah setelan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_UDP_SEG_DISABLED | USO dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_UDP_SEG_ENABLED | USO diaktifkan. |
UdpRsc
Struktur yang menjelaskan pengaturan UDP Receive Segment Coalescing Offload (URO) adaptor miniport.
UdpRsc.Enabled
Pengaturan URO adaptor miniport. Pengaturan ini harus menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| NDIS_OFFLOAD_PARAMETERS_UDP_RSC_NO_CHANGE 0 |
Pengandar miniport tidak boleh mengubah setelan saat ini. |
| NDIS_OFFLOAD_PARAMETERS_UDP_RSC_DISABLED 1 |
URO dinonaktifkan. |
| NDIS_OFFLOAD_PARAMETERS_UDP_RSC_ENABLED 2 |
URO diaktifkan. |
Keterangan
Menanggapi permintaan set OID_TCP_OFFLOAD_PARAMETERS OID, driver miniport menggunakan pengaturan dalam struktur NDIS_OFFLOAD_PARAMETERS untuk mengatur konfigurasi adaptor miniport saat ini.
NDIS mempertahankan pengaturan yang diminta dalam registri dalam kata kunci standar offload. Ketika NDIS memulai ulang adaptor miniport, driver miniport membaca kata kunci standar offload dan menggunakannya untuk mengatur konfigurasi offload default NIC.
Untuk mengakses pengaturan offload checksum, gunakan anggota struktur NDIS_OFFLOAD_PARAMETERS berikut:
IPv4Checksum
TCPIPv4Checksum
UDPIPv4Checksum
TCPIPv6Checksum
UDPIPv6Checksum
Anggota sebelumnya dapat memiliki salah satu nilai berikut:
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE
Pengandar miniport tidak boleh mengubah setelan saat ini.
NDIS_OFFLOAD_PARAMETERS_TX_RX_DISABLED
Fitur yang ditentukan anggota dinonaktifkan.
NDIS_OFFLOAD_PARAMETERS_TX_ENABLED_RX_DISABLED
Fitur yang ditentukan anggota diaktifkan untuk dikirimkan dan dinonaktifkan untuk diterima.
NDIS_OFFLOAD_PARAMETERS_RX_ENABLED_TX_DISABLED
Fitur yang ditentukan anggota diaktifkan untuk menerima dan dinonaktifkan untuk transmisi.
NDIS_OFFLOAD_PARAMETERS_TX_RX_ENABLED
Fitur yang ditentukan anggota diaktifkan untuk dikirimkan dan diterima.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista,Didukung di NDIS 6.0 dan yang lebih baru. |
| Server minimum yang didukung | Windows Server 2008 |
| Header | ntddndis.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk