OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX
[La característica IPsec Task Offload está en desuso y no se debe usar.]
Como conjunto, el transporte TCP/IP usa el OID de OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX 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 NDIS 6.1 Direct OID Request Interface(Interfaz de solicitud OID directa).
Observaciones
Todos los controladores de miniporte NDIS 6.30 que admiten la descarga 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 que agregue SAs. El transporte no puede descargar las operaciones IPsecOV2 a la NIC antes de que el transporte agregue una SA.
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_EX, el controlador de minipuerto proporciona el identificador que identifica la SA descargada en el miembro OffloadHandle de la estructura IPSEC_OFFLOAD_V2_ADD_SA_EX . (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 una SA, la solicitud establecida se realiza correctamente.
El controlador de miniporte 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 controlador de minipuerto podría devolver un estado de error porque necesita evitar una condición de carrera. En este caso, la configuración de la NIC cambia y excluye un algoritmo determinado.
Si se produce un error en la solicitud, las SAs no se descargaron. Si se produce un error para una SA, el controlador de minipuerto debe establecer el miembro OffloadHandle en la estructura de IPSEC_OFFLOAD_V2_ADD_SA_EX 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.
Este OID es esencialmente idéntico a la versión anterior, OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA. La única diferencia es la estructura de IPSEC_OFFLOAD_V2_ADD_SA_EX actualizada.
Requisitos
Versión |
Compatible con NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |