OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA

[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 OID para solicitar que um driver de miniporta adicione as associações de segurança (SAs) especificadas 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.

Nota Este OID é suportado no NDIS 6.1 e 6.20. Para drivers NDIS 6.30 e posteriores, consulte OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX.

Comentários

Todos os drivers de miniporta NDIS 6.1 e 6.20 que suportam IPsec offload 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 recebe uma estrutura IPSEC_OFFLOAD_V2_ADD_SA que contém um ponteiro para a próxima estrutura IPSEC_OFFLOAD_V2_ADD_SA em uma lista vinculada. 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, o driver de miniporta fornece as alças que identificam as SAs descarregadas no OffloadHandle membro do IPSEC_OFFLOAD_V2_ADD_SA. (Por exemplo, o transporte usa o identificador no caminho de envio para indicar qual SA descarregada usar). Se qualquer uma das SAs na lista vinculada 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, nenhuma das SAs na lista vinculada será descarregada. Se ocorrer falha para uma SA específica na lista vinculada, o driver de miniporta deve definir o membro OffloadHandle na estrutura de IPSEC_OFFLOAD_V2_ADD_SA correspondente como 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.