OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA
[La característica de descarga de tareas IPsec está en desuso y no debe usarse.
Como conjunto, el transporte TCP/IP usa el OID de OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA para solicitar que un controlador de miniporte agregue las asociaciones de seguridad (SAs) especificadas a una NIC.
Nota NDIS admite este OID con la interfaz de solicitud OID directa. Para obtener más información sobre la interfaz de solicitud OID directa, consulte Interfaz de solicitud OID directa de NDIS 6.1.
Nota Este OID se admite en NDIS 6.1 y 6.20. Para los controladores NDIS 6.30 y versiones posteriores, consulte OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX.
Observaciones
Todos los controladores de minipuerto NDIS 6.1 y 6.20 que admiten la descarga de IPsec versión 2 (IPsecOV2) deben admitir este OID.
Una vez que el transporte TCP/IP determina que una NIC puede realizar operaciones IPsecOV2, el transporte TCP/IP solicita al controlador de miniporte agregar SAs. El transporte no puede descargar las operaciones IPsecOV2 a la NIC antes de que el transporte agregue una SA.
El controlador de minipuerto recibe una estructura IPSEC_OFFLOAD_V2_ADD_SA que contiene un puntero a la siguiente estructura IPSEC_OFFLOAD_V2_ADD_SA de una lista vinculada. El controlador de minipuerto configura la NIC para el procesamiento de IPsecOV2 en los SAs. Con un conjunto correcto en OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA, el controlador de minipuerto proporciona los controladores que identifican los SAs descargados en el miembro OffloadHandle de IPSEC_OFFLOAD_V2_ADD_SA. (Por ejemplo, el transporte usa el identificador en la ruta de acceso de envío para indicar qué SA descargada se va a usar). Si se ha descargado alguno de los SAs de la lista vinculada, la solicitud set se realiza correctamente.
El controlador de minipuerto puede devolver un estado de error para la solicitud OID, por ejemplo, cuando la NIC se queda sin capacidad para descargar más SAs. Además, el miniportador puede devolver un estado de error porque necesita evitar una condición de carrera. En este caso, la configuración de NIC cambia y excluye un algoritmo determinado.
Si se produce un error en la solicitud, ninguno de los SAs de la lista vinculada se ha descargado. Si se produce un error para una SA determinada en la lista vinculada, el controlador de minipuerto debe establecer el miembro OffloadHandle en la estructura IPSEC_OFFLOAD_V2_ADD_SA correspondiente en NULL.
El controlador de minipuerto informa del número máximo de SAs que una NIC puede admitir en el miembro SaOffloadCapacity de la estructura NDIS_IPSEC_OFFLOAD_V2 durante la inicialización. Si es necesario, el transporte TCP/IP puede establecer el OID de OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA para solicitar que el controlador de miniporte elimine una SA de la NIC.
Requisitos
Versión |
Compatible con NDIS 6.1 y 6.20. Para NDIS 6.30 y versiones posteriores, use OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |