Partilhar via


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)

Confira também

IPSEC_OFFLOAD_V2_ADD_SA

NDIS_IPSEC_OFFLOAD_V2

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX

OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA