OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA

[Функция разгрузки задачи IPsec устарела и не должна использоваться.]

В качестве набора транспорт TCP/IP использует OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID, чтобы запросить, чтобы минипорт-драйвер добавил указанные связи безопасности (SAs) в сетевой адаптер.

примечание NDIS поддерживает этот OID с помощью интерфейса прямого запроса OID. Дополнительные сведения об интерфейсе прямого запроса OID см. винтерфейсе прямого запроса OID NDIS 6.1.

примечание этот OID поддерживается в NDIS 6.1 и 6.20. Для драйверов NDIS 6.30 и более поздних версий см. OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX.

Замечания

Все драйверы минипорта NDIS 6.1 и 6.20, поддерживающие разгрузку IPsec версии 2 (IPsecOV2), должны поддерживать этот OID.

После того как транспорт TCP/IP определяет, что сетевой адаптер может выполнять операции IPsecOV2, транспорт TCP/IP запрашивает мини-драйвер для добавления SAS. Транспорт не может выгрузить операции IPsecOV2 в сетевой адаптер, прежде чем транспорт добавляет SA.

Драйвер минипорта получает IPSEC_OFFLOAD_V2_ADD_SA структуру, содержащую указатель на следующую IPSEC_OFFLOAD_V2_ADD_SA структуру в связанном списке. Минипорт-драйвер настраивает сетевой адаптер для обработки IPsecOV2 для SAs. При успешном OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA драйвер минипорта предоставляет дескриптор, определяющий отключенные SAs в OffloadHandle члена IPSEC_OFFLOAD_V2_ADD_SA. (Например, транспорт использует дескриптор в пути отправки, чтобы указать, какие выгрузили SA для использования. Если какие-либо из SAs в связанном списке были выгружены, запрос набора выполнен успешно.

Минипорт-драйвер может вернуть состояние сбоя для запроса OID, например, когда сетевой адаптер не может загружать больше единиц обслуживания. Кроме того, минипорт-водитель может вернуть состояние сбоя, так как он должен избежать состояния гонки. В этом случае конфигурация сетевого адаптера изменяется и исключает определенный алгоритм.

Если запрос завершается ошибкой, ни один из SAs в связанном списке не был загружен. Если ошибка возникает для конкретного sa в связанном списке, драйвер минипорта должен задать элемент OffloadHandle в соответствующей структуре IPSEC_OFFLOAD_V2_ADD_SA значение NULL.

Драйвер минипорта сообщает максимальное количество SAS, которое сетевой адаптер может поддерживать в SaOffloadCapacity член структуры NDIS_IPSEC_OFFLOAD_V2 во время инициализации. При необходимости транспорт TCP/IP может задать OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID, чтобы запросить, чтобы минипорт-драйвер удалил SA из сетевой карты.

Требования

См. также

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