Share via

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA

  • Artikel

[Fitur Offload Tugas IPsec tidak digunakan lagi dan tidak boleh digunakan.]

Sebagai set, transportasi TCP/IP menggunakan OID OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA untuk meminta driver miniport menambahkan asosiasi keamanan (SAs) yang ditentukan ke NIC.

Catatan NDIS mendukung OID ini dengan antarmuka permintaan OID langsung. Untuk informasi selengkapnya tentang antarmuka permintaan OID langsung, lihat Antarmuka Permintaan OID Langsung NDIS 6.1.

Catatan OID ini didukung di NDIS 6.1 dan 6.20. Untuk driver NDIS 6.30 dan yang lebih baru, lihat OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX.

Keterangan

Semua driver miniport NDIS 6.1 dan 6.20 yang mendukung offload IPsec versi 2 (IPsecOV2) harus mendukung OID ini.

Setelah transportasi TCP/IP menentukan bahwa NIC dapat melakukan operasi IPsecOV2, transportasi TCP/IP meminta driver miniport untuk menambahkan SAs. Transportasi tidak dapat membongkar operasi IPsecOV2 ke NIC sebelum transportasi menambahkan SA.

Driver miniport menerima struktur IPSEC_OFFLOAD_V2_ADD_SA yang berisi penunjuk ke struktur IPSEC_OFFLOAD_V2_ADD_SA berikutnya dalam daftar yang ditautkan. Driver miniport mengonfigurasi NIC untuk pemrosesan IPsecOV2 pada SAs. Dengan keberhasilan diatur ke OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA, driver miniport memasok handel yang mengidentifikasi SAs yang dibongkar di anggota OffloadHandle IPSEC_OFFLOAD_V2_ADD_SA. (Misalnya, transportasi menggunakan handel di jalur kirim untuk menunjukkan SA yang dibongkar mana yang akan digunakan). Jika salah satu SA dalam daftar tertaut diturunkan, permintaan yang ditetapkan berhasil.

Driver miniport dapat mengembalikan status kegagalan untuk permintaan OID, misalnya, ketika NIC kehabisan kapasitas untuk membongkar lebih banyak SAs. Selain itu, pembalap miniport mungkin mengembalikan status kegagalan karena perlu menghindari kondisi balapan. Dalam hal ini, konfigurasi NIC berubah dan mengecualikan algoritma tertentu.

Jika permintaan gagal, tidak ada SAs dalam daftar tertaut yang dilepaskan. Jika kegagalan terjadi untuk SA tertentu dalam daftar yang ditautkan, driver miniport harus mengatur anggota OffloadHandle dalam struktur IPSEC_OFFLOAD_V2_ADD_SA yang sesuai ke NULL.

Driver miniport melaporkan jumlah maksimum SAs yang dapat didukung NIC di anggota SaOffloadCapacity dari struktur NDIS_IPSEC_OFFLOAD_V2 selama inisialisasi. Jika perlu, transportasi TCP/IP dapat mengatur OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID untuk meminta driver miniport menghapus SA dari NIC.

Persyaratan

Versi

Didukung di NDIS 6.1 dan 6.20. Untuk NDIS 6.30 dan yang lebih baru, gunakan OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX.

Header

 Ntddndis.h (termasuk Ndis.h)

Lihat juga

IPSEC_OFFLOAD_V2_ADD_SA

NDIS_IPSEC_OFFLOAD_V2

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX

OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA