OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX
[O recurso IPsec Task Offload foi preterido e não deve ser usado.]
Como um conjunto, o transporte TCP/IP usa o OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX OID para solicitar que um driver de miniporta adicione as associações de segurança especificadas (SAs) a uma NIC.
Nota o NDIS suporta este OID com a interface de solicitação OID direta. Para obter mais informações sobre a interface de solicitação OID direta, consulte NDIS 6.1 Direct OID Request Interface.
Comentários
Todos os drivers de miniporta NDIS 6.30 que suportam descarregamento IPsec versão 2 (IPsecOV2) devem suportar este OID.
Depois que o transporte TCP/IP determina que uma NIC pode executar operações IPsecOV2, o transporte TCP/IP solicita que o driver de miniporta adicione SAs. O transporte não pode descarregar operações IPsecOV2 para a NIC antes que o transporte adicione uma SA.
O driver de miniporta configura a NIC para processamento IPsecOV2 nas SAs. Com um conjunto bem-sucedido para OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX, o driver de miniporta fornece o identificador que identifica a SA descarregada no OffloadHandle membro da estrutura IPSEC_OFFLOAD_V2_ADD_SA_EX. (Por exemplo, o transporte usa o identificador no caminho de envio para indicar qual SA descarregada usar). Se uma SA foi descarregada, a solicitação de conjunto é bem-sucedida.
O driver de miniporta pode retornar um status de falha para a solicitação OID, por exemplo, quando a NIC fica sem capacidade para descarregar mais SAs. Além disso, o motorista da miniporta pode retornar um status de falha porque precisa evitar uma condição de corrida. Nesse caso, a configuração da NIC é alterada e exclui um algoritmo específico.
Se a solicitação falhar, as SAs não serão descarregadas. Se ocorrer falha para uma SA, o driver de miniporta deve definir o membro OffloadHandle na estrutura de IPSEC_OFFLOAD_V2_ADD_SA_EX correspondente para NULL.
O driver de miniporta relata o número máximo de SAs que uma NIC pode suportar no SaOffloadCapacity membro da estrutura NDIS_IPSEC_OFFLOAD_V2 durante a inicialização. Se necessário, o transporte TCP/IP pode definir o OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID para solicitar que o driver de miniporta exclua uma SA da NIC.
Este OID é essencialmente idêntico à versão anterior, OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA. A única diferença é a estrutura IPSEC_OFFLOAD_V2_ADD_SA_EX atualizada.
Requerimentos
Versão |
Suportado no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |