OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA
[O recurso de descarregamento de tarefa IPsec 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 miniporto adicione as SAs (associações de segurança) especificadas a uma NIC.
Nota O NDIS dá suporte a esse OID com a interface de solicitação OID direta. Para obter mais informações sobre a interface de solicitação OID direta, consulte Interface de solicitação OID direta do NDIS 6.1.
Nota Esse OID tem suporte no NDIS 6.1 e 6.20. Para drivers NDIS 6.30 e posteriores, confira OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX.
Comentários
Todos os drivers de miniporta NDIS 6.1 e 6.20 que dão suporte ao descarregamento IPsec versão 2 (IPsecOV2) devem dar suporte a esse 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 miniporto 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 nos SAs. Com um conjunto bem-sucedido para OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA, o driver de miniporto fornece as alças que identificam os SAs descarregados no membro OffloadHandle 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 um dos SAs na lista vinculada tiver sido descarregado, a solicitação set será bem-sucedida.
O driver de miniporta pode retornar uma status de falha para a solicitação OID, por exemplo, quando a NIC fica sem capacidade para descarregar mais SAs. Além disso, o piloto de miniporta pode retornar uma falha status porque precisa evitar uma condição de corrida. Nesse caso, a configuração da NIC muda e exclui um algoritmo específico.
Se a solicitação falhar, nenhum dos SAs na lista vinculada foi descarregado. Se ocorrer falha para uma SA específica na lista vinculada, o driver de miniporto deverá definir o membro OffloadHandle na estrutura de IPSEC_OFFLOAD_V2_ADD_SA correspondente como NULL.
O driver de miniporto relata o número máximo de SAs aos quais uma NIC pode dar suporte no membro SaOffloadCapacity 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 miniporto exclua uma SA da NIC.
Requisitos
Versão |
Com suporte no NDIS 6.1 e 6.20. Para o NDIS 6.30 e posterior, use OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |