OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA
[Функция разгрузки задач IPsec является устаревшей и не должна использоваться.]
В качестве набора транспорт TCP/IP использует OID OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA для запроса на добавление драйвера мини-порта указанных сопоставлений безопасности (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 miniport, поддерживающие разгрузку 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. Кроме того, водитель мини-порта может вернуть состояние сбоя, так как ему необходимо, чтобы избежать состояния гонки. В этом случае конфигурация сетевой карты изменяется и исключает определенный алгоритм.
Если запрос завершается сбоем, ни один из 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 из сетевого адаптера.
Требования
Версия |
Поддерживается в NDIS 6.1 и 6.20. Для NDIS 6.30 и более поздних версий используйте OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX. |
Заголовок |
Ntddndis.h (включая Ndis.h) |