OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX
[Функция разгрузки задач IPsec является устаревшей и не должна использоваться.]
В качестве набора транспорт TCP/IP использует OID OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX для запроса на добавление драйвера мини-порта указанных связей безопасности (SAs) в сетевой адаптер.
Примечание NDIS поддерживает этот OID с помощью интерфейса прямого запроса OID. Дополнительные сведения об интерфейсе прямого запроса OID см. в разделе Интерфейс прямого запроса OID NDIS 6.1.
Комментарии
Все драйверы мини-портов NDIS 6.30, поддерживающие разгрузку IPsec версии 2 (IPsecOV2), должны поддерживать этот OID.
После того как транспорт TCP/IP определяет, что сетевой адаптер может выполнять операции IPsecOV2, транспорт TCP/IP запрашивает драйвер мини-порта для добавления SAS. Транспорт не может выгрузить операции IPsecOV2 на сетевой адаптер до того, как транспорт добавит sa.
Драйвер мини-порта настраивает сетевой адаптер для обработки IPsecOV2 в SAs. После успешного задания OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA_EX драйвер мини-порта предоставляет дескриптор, который идентифицирует разгрузку SA в элементе OffloadHandleструктуры IPSEC_OFFLOAD_V2_ADD_SA_EX . (Например, транспорт использует дескриптор в пути отправки, чтобы указать, какой выгружаемый sa следует использовать. Если sa был разгружен, запрос на набор выполняется успешно.
Драйвер мини-порта может возвращать состояние сбоя для запроса OID, например, когда у сетевого адаптера заканчивается емкость для разгрузки дополнительных SAS. Кроме того, водитель мини-порта может вернуть состояние сбоя, так как ему необходимо избежать состояния гонки. В этом случае конфигурация сетевой карты изменяется и исключает определенный алгоритм.
Если запрос завершается сбоем, SAS не были разгружены. При сбое для sa драйвер минипорта должен задать для элемента OffloadHandle в соответствующей структуре IPSEC_OFFLOAD_V2_ADD_SA_EX значение NULL.
Драйвер мини-порта сообщает максимальное количество SAS, которое может поддерживать сетевой адаптер в элементе SaOffloadCapacity структуры NDIS_IPSEC_OFFLOAD_V2 во время инициализации. При необходимости транспорт TCP/IP может задать OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID, чтобы запросить, чтобы драйвер мини-порта удалил sa из сетевой карты.
Этот OID по существу идентичен предыдущей версии , OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA. Единственным отличием является обновленная структура IPSEC_OFFLOAD_V2_ADD_SA_EX .
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |