OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX
[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_EX 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.
Keterangan
Semua driver miniport NDIS 6.30 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 mengonfigurasi NIC untuk pemrosesan IPsecOV2 pada SAs. Dengan keberhasilan diatur ke OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX, driver miniport memasok handel yang mengidentifikasi SA yang dibongkar di anggota OffloadHandle dari struktur IPSEC_OFFLOAD_V2_ADD_SA_EX . (Misalnya, transportasi menggunakan handel di jalur kirim untuk menunjukkan SA yang dibongkar mana yang akan digunakan). Jika SA dibongkar, 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, SAs tidak dilepas. Jika kegagalan terjadi untuk SA, driver miniport harus mengatur anggota OffloadHandle dalam struktur IPSEC_OFFLOAD_V2_ADD_SA_EX 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.
OID ini pada dasarnya identik dengan versi sebelumnya, OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA. Satu-satunya perbedaan adalah struktur IPSEC_OFFLOAD_V2_ADD_SA_EX yang diperbarui.
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |