struktur NDIS_IPSEC_OFFLOAD_V1 (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_IPSEC_OFFLOAD_V1 menyediakan informasi offload tugas keamanan protokol Internet (IPsec) dalam struktur NDIS_OFFLOAD .

CatatanNDIS_IPSEC_OFFLOAD_V1 hanya untuk NDIS 6.0. Untuk NDIS 6.1 dan yang lebih baru, gunakan NDIS_IPSEC_OFFLOAD_V2.

Sintaks

typedef struct _NDIS_IPSEC_OFFLOAD_V1 {
  struct {
    ULONG Encapsulation;
    ULONG AhEspCombined;
    ULONG TransportTunnelCombined;
    ULONG IPv4Options;
    ULONG Flags;
  } Supported;
  struct {
    ULONG Md5 : 2;
    ULONG Sha_1 : 2;
    ULONG Transport : 2;
    ULONG Tunnel : 2;
    ULONG Send : 2;
    ULONG Receive : 2;
  } IPv4AH;
  struct {
    ULONG Des : 2;
    ULONG Reserved : 2;
    ULONG TripleDes : 2;
    ULONG NullEsp : 2;
    ULONG Transport : 2;
    ULONG Tunnel : 2;
    ULONG Send : 2;
    ULONG Receive : 2;
  } IPv4ESP;
} NDIS_IPSEC_OFFLOAD_V1, *PNDIS_IPSEC_OFFLOAD_V1;

Anggota

Supported

Struktur dalam NDIS_IPSEC_OFFLOAD_V1 yang menentukan dukungan untuk offload tugas IPsec dan yang berisi informasi berikut:

Supported.Encapsulation

Pengaturan enkapulasi untuk IPsec. Untuk informasi selengkapnya tentang anggota ini, lihat bagian Keterangan berikut ini.

Supported.AhEspCombined

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa perangkat keras dapat melakukan operasi IPsec pada paket kirim dan terima yang berisi payload keamanan header autentikasi (AH) dan payload keamanan enkapsultasi (ESP). Nilai nol dalam AhEspCombined menunjukkan bahwa NIC tidak mendukung kemampuan ini.

Supported.TransportTunnelCombined

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat memproses payload keamanan untuk bagian mode transportasi dan bagian mode terowongan dari paket kirim dan terima. (Bagian mode transportasi dari paket berkaitan dengan koneksi end-to-end. Bagian mode terowongan dari paket berkaitan dengan koneksi terowongan.) Nilai nol di TransportTunnelCombined menunjukkan bahwa NIC tidak mendukung kemampuan ini.

Supported.IPv4Options

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat melakukan operasi IPsec pada paket kirim dan terima IPv4 yang header IP-nya berisi opsi IP. Nilai nol dalam IPv4Options menunjukkan bahwa NIC tidak mendukung kemampuan ini.

Supported.Flags

Jenis paket data ESP yang dienkapsulasi UDP yang dapat diurai NIC. Untuk deskripsi jenis enkapulasi UDP, lihat Jenis Enkapsulasi UDP-ESP. Anggota ini bisa menjadi satu atau beberapa bendera berikut:

Nilai	Makna
IPSEC_TPT_UDPESP_ENCAPTYPE_IKE	Dicadangkan untuk penggunaan internal.
IPSEC_TUN_UDPESP_ENCAPTYPE_IKE	Dicadangkan untuk penggunaan internal.
IPSEC_TPTOVERTUN_UDPESP_ENCAPTYPE_IKE	Dicadangkan untuk penggunaan internal.
IPSEC_TPT_UDPESP_OVER_PURE_TUN_ENCAPTYPE_IKE	Dicadangkan untuk penggunaan internal.
IPSEC_TPT_UDPESP_ENCAPTYPE_OTHER	Ketika bendera ini diatur, NIC dapat mengurai paket mode transportasi yang dienkapsulasi UDP. Ketika bendera ini dibersihkan, NIC tidak dapat mengurai paket mode transportasi yang dienkapsulasi UDP.
IPSEC_TUN_UDPESP_ENCAPTYPE_OTHER	Ketika bendera ini diatur, NIC dapat mengurai paket mode terowongan yang dienkapsulasi UDP. Ketika bendera ini dibersihkan, NIC tidak memiliki kemampuan ini.
IPSEC_TPTOVERTUN_UDPESP_ENCAPTYPE_OTHER	Ketika bendera ini diatur, NIC dapat mengurai transportasi melalui paket mode terowongan yang dienkapsulasi UDP. Ketika bendera ini dibersihkan, NIC tidak memiliki kemampuan ini.
IPSEC_TPT_UDPESP_OVER_PURE_TUN_ENCAPTYPE_OTHER	Ketika bendera ini diatur, NIC dapat mengurai transportasi yang dienkapsulasi UDP melalui paket mode terowongan. Ketika bendera ini dibersihkan, NIC tidak memiliki kemampuan ini.

Driver miniport yang NIC-nya tidak mampu mengurai paket ESP yang dienkapsulasi UDP tidak boleh mengatur bendera apa pun di anggota Bendera .

IPv4AH

Struktur dalam NDIS_IPSEC_OFFLOAD_V1 yang menentukan dukungan untuk payload AH dan yang berisi informasi berikut:

IPv4AH.Md5

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat menggunakan algoritma MD5 kunci untuk menghitung atau memvalidasi checksum kriptografi untuk payload AH, payload ESP, atau keduanya.

IPv4AH.Sha_1

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat menggunakan algoritma SHA 1 untuk menghitung atau memvalidasi checksum kriptografi untuk payload AH, payload ESP, atau keduanya.

IPv4AH.Transport

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat menghitung atau memvalidasi checksum kriptografi untuk bagian paket yang berkaitan dengan koneksi end-to-end.

IPv4AH.Tunnel

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat menghitung atau memvalidasi checksum kriptografi untuk bagian paket yang berkaitan dengan koneksi terowongan.

IPv4AH.Send

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat menghitung checksum kriptografi untuk mengirim paket.

IPv4AH.Receive

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat memvalidasi checksum kriptografi untuk menerima paket.

IPv4ESP

Struktur dalam NDIS_IPSEC_OFFLOAD_V1 yang menentukan dukungan untuk payload ESP dan yang berisi informasi berikut:

IPv4ESP.Des

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC mendukung algoritma DES untuk mengenkripsi dan mendekripsi payload ESP.

IPv4ESP.Reserved

Anggota ini dicadangkan.

IPv4ESP.TripleDes

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC mendukung algoritma triple-DES untuk mengenkripsi dan mendekripsi payload ESP.

IPv4ESP.NullEsp

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC mendukung enkripsi null--yaitu, payload ESP tanpa enkripsi tetapi dengan informasi autentikasi.

IPv4ESP.Transport

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat mengenkripsi dan mendekripsi data ESP untuk bagian paket yang berkaitan dengan koneksi end-to-end.

IPv4ESP.Tunnel

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat mengenkripsi dan mendekripsi data ESP untuk bagian paket yang berkaitan dengan koneksi terowongan.

IPv4ESP.Send

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat mengenkripsi dan mendekripsi payload ESP dalam paket kirim.

IPv4ESP.Receive

Nilai ULONG yang ditetapkan driver miniport untuk menunjukkan bahwa NIC dapat mengenkripsi dan mendekripsi payload ESP dalam paket penerima.

Keterangan

Struktur NDIS_IPSEC_OFFLOAD_V1 digunakan dalam anggota IPsecV1 dari struktur NDIS_OFFLOAD . Struktur NDIS_IPSEC_OFFLOAD_V1 menentukan layanan saat ini atau yang didukung yang disediakan adaptor miniport untuk keamanan protokol Internet (IPsec).

NDIS_OFFLOAD digunakan dalam struktur NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES , struktur NDIS_BIND_PARAMETERS , NDIS_FILTER_ATTACH_PARAMETERS struktur, OID_TCP_OFFLOAD_CURRENT_CONFIG OID, dan NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indikasi status.

Untuk OID_TCP_OFFLOAD_CURRENT_CONFIG, struktur NDIS_OFFLOAD menentukan kemampuan offload tugas yang didukung adaptor miniport. Jika kemampuan offload saat ini berubah, driver miniport melaporkan kemampuan baru dalam NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indikasi status.

Anggota EnkapulasiNDIS_IPSEC_OFFLOAD_V1 menentukan pengaturan enkapulasi offload IPsec untuk adaptor miniport.

Menanggapi OID_TCP_OFFLOAD_CURRENT_CONFIG permintaan kueri, NDIS menyediakan bitwise OR dari bendera enkapulasi, yang menunjukkan pengaturan enkapulasi yang didukung, di anggota Enkapulasi . Driver miniport harus menyediakan enkapulasi Ethernet (NDIS_ENCAPSULATION_IEEE_802_3). Jenis enkapulasi lainnya bersifat opsional.

Untuk NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indikasi status, driver miniport menyediakan bitwise OR dari bendera enkapulasi, yang menunjukkan kemampuan saat ini, di anggota Enkapulasi .

Bendera berikut didefinisikan untuk anggota Enkapulasi :