OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA
[IPsec 任务卸载功能已弃用,不应使用。]
作为集,TCP/IP 传输使用 OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID 请求微型端口驱动程序从 NIC 中删除指定的安全关联 (SA) 。
注意 NDIS 通过直接 OID 请求接口支持此 OID。 有关直接 OID 请求接口的详细信息,请参阅 NDIS 6.1 直接 OID 请求接口。
注解
支持 IPsec 卸载版本 2 (IPsecOV2) 的所有 NDIS 6.1 微型端口驱动程序都必须支持此 OID。
当微型端口驱动程序收到此请求时,驱动程序应从 NIC 中删除指定的 SA,并释放为该 SA 分配的任何系统资源。
微型端口驱动程序接收 一个IPSEC_OFFLOAD_V2_DELETE_SA 结构,该结构包含 SA 捆绑的句柄和指向链接列表中的下一个 IPSEC_OFFLOAD_V2_DELETE_SA 结构的指针。
微型端口驱动程序可以在接收NET_BUFFER_LIST结构的 NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO 结构中设置 SaDeleteReq。 TCP/IP 传输随后发出OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA一次,以删除通过数据包接收的入站 SA,并再次删除与已删除的入站 SA 对应的出站 SA。 在收到相应的OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA请求之前,NIC 不得删除其中任一 SA。
返回状态代码
微型端口驱动程序的 MiniportOidRequest 函数为此请求返回以下值之一:
术语 | 说明 |
---|---|
NDIS_STATUS_SUCCESS |
微型端口驱动程序成功完成了请求。 |
NDIS_STATUS_PENDING |
微型端口驱动程序将以异步方式完成请求。 微型端口驱动程序完成所有处理后,它必须通过调用 NdisMOidRequestComplete 函数、传递 Status 参数NDIS_STATUS_SUCCESS来使请求成功。 |
NDIS_STATUS_NOT_ACCEPTED |
微型端口驱动程序正在重置。 |
NDIS_STATUS_REQUEST_ABORTED |
微型端口驱动程序已停止处理请求。 例如,NDIS 调用 MiniportResetEx 函数。 |
要求
版本 |
在 NDIS 6.1 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |