Функция NdisCloseAddressFamily (ndis.h)

Статья
08/07/2023

NdisCloseAddressFamily освобождает связь между клиентским протоколом и зарегистрированной AF диспетчера вызовов или драйвера MCM для определенной сетевой карты, к которой привязан клиент.

Синтаксис

NDIS_STATUS NdisClCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Параметры

[in] NdisAfHandle

Указывает предоставленный NDIS-дескриптор, возвращаемый NdisClOpenAddressFamilyEx.

Возвращаемое значение

When NdisCloseAddressFamily возвращает что-либо, кроме NDIS_STATUS_PENDING, клиент должен выполнить внутренний вызов Функция ProtocolCloseAfComplete . В противном случае NDIS вызывает клиент Функция ProtocolCloseAfComplete после завершения этой операции.

If NdisCloseAddressFamily возвращает NDIS_STATUS_PENDING клиента, который ожидает егоВызываемая функция ProtocolCloseAfComplete не должна блокировать текущий поток, так как это может привести к взаимоблокировке. Это особенно важно, когда клиент вызывает NdisCloseAddressFamily в контексте обработки Запрос NdisCmNotifyCloseAddressFamily . В этом случае диспетчер вызовов не может закрыть семейство адресов до тех пор, пока клиент не вернется из обработки запроса NdisCmNotifyCloseAddressFamily . Если клиент блокирует текущий поток, клиент никогда не завершит обработку запроса NdisCmNotifyCloseAddressFamily , что приведет к взаимоблокировке.

Клиент обычно вызывает NdisCloseAddressFamily из своей
Функция ProtocolUnbindAdapterEx после закрытия всех открытых виртуальных машин клиента в привязке с помощью вызовов NdisClCloseCall и (или) NdisClDeregisterSap. Клиент также может вызвать NdisCloseAddressFamily в контексте обработки Запрос NdisCmNotifyCloseAddressFamily .

NDIS вызывает клиент Функция ProtocolUnbindAdapterEx при удалении с компьютера или перенастройке базового сетевого адаптера, к которому привязан этот клиент. Перенастройка PnP базового драйвера мини-порта приводит к тому, что диспетчер вызовов или драйвер MCM перерегистрирует семейство адресов, которое он поддерживает для этого сетевого адаптера. Это, в свою очередь, вызывает последующий вызов клиента Функция ProtocolCoAfRegisterNotify . В обоих случаях клиентФункция ProtocolUnbindAdapterEx должна вызывать NdisCloseAddressFamily с любым текущим NdisAfHandle, который зависит от базового драйвера минипорта.

В качестве общего руководства клиент должен освободить все ресурсы, выделенные для связи, ориентированной на подключение, через драйвер мини-порта до его Функция ProtocolUnbindAdapterEx вызывает NdisCloseAdapterEx.

NdisAfHandle, переданный в NdisCloseAddressFamily, становится недопустимым для клиента сразу после этого вызова.

Перед вызовом NdisCloseAddressFamily клиент может использовать NdisAfHandle , когда af is open or while aОперация ProtocolClNotifyCloseAf ожидается. Если Функция ProtocolClNotifyCloseAf возвращает NDIS_STATUS_PENDING, используйте дескриптор в Вызов NdisClNotifyCloseAddressFamilyComplete после завершения операции закрытия.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisCloseAddressFamily (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisCloseAddressFamily (NDIS 5.1)) в Windows XP.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_Protocol_Driver_Function(ndis)