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

Статья
02/26/2024

Функция NdisCmNotifyCloseAddressFamily уведомляет NDIS о том, что диспетчер вызовов отменяет привязку к базовому адаптеру мини-порта и что все связанные клиенты CoNDIS должны закрыть указанное семейство адресов (AF).

Синтаксис

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Параметры

[in] NdisAfHandle

Дескриптор NDIS, который идентифицирует af, который должен закрыть NDIS. NDIS предоставил этот дескриптор функции ProtocolCmOpenAf диспетчера вызовов.

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

NdisCmNotifyCloseAddressFamily может возвращать одно из следующих элементов:

Код возврата	Описание
NDIS_STATUS_SUCCESS	NDIS успешно закрыл семейство адресов.
NDIS_STATUS_PENDING	NDIS обрабатывает этот запрос асинхронно и вызывает диспетчера вызовов. Функция ProtocolCmNotifyCloseAfComplete по завершении операции закрытия.
NDIS_STATUS_XXX	NDIS не удалось выполнить запрос по какой-либо причине, определенной NDIS или драйвером клиента.

Автономные диспетчеры вызовов CoNDIS, которые регистрируются в качестве драйверов протокола NDIS путем вызоваФункция NdisRegisterProtocolDriver может вызывать функцию NdisCmNotifyCloseAddressFamily. Вместо этого диспетчеры вызовов минипорта (MCM) вызываютФункция NdisMCmNotifyCloseAddressFamily.

Чтобы закрыть AF для привязки, автономный диспетчер вызовов должен вызвать NdisCmNotifyCloseAddressFamily из Функция ProtocolUnbindAdapterEx . Затем NDIS вызывает Функция ProtocolClNotifyCloseAf клиента, у которого открыта указанная AF.

Если NdisCmNotifyCloseAddressFamily возвращает NDIS_STATUS_PENDING, NDIS вызывает диспетчера вызовов. Функция ProtocolCmNotifyCloseAfComplete после завершения клиентом операции закрытия AF.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	Irql_CallManager_Function(ndis)