OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX

[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_EX 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.

Comentários

Todos os drivers de miniporta NDIS 6.30 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 configura a NIC para processamento IPsecOV2 nos SAs. Com um conjunto bem-sucedido para OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX, o driver de miniporto fornece o identificador que identifica a SA descarregada no membro OffloadHandle 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 tiver sido descarregada, a solicitação definida 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, os SAs não foram descarregados. Se ocorrer falha para uma SA, o driver de miniporto deverá definir o membro OffloadHandle na estrutura de IPSEC_OFFLOAD_V2_ADD_SA_EX 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.

Essa OID é essencialmente idêntica à versão anterior, OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA. A única diferença é a estrutura de IPSEC_OFFLOAD_V2_ADD_SA_EX atualizada.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

parâmetro

Ntddndis.h (inclua Ndis.h)

Confira também

IPSEC_OFFLOAD_V2_ADD_SA_EX

NDIS_IPSEC_OFFLOAD_V2

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA

OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA