Поделиться через


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

Функция 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)

См. также раздел

NdisMCmNotifyCloseAddressFamily

NdisRegisterProtocolDriver

ProtocolClNotifyCloseAf

ProtocolCmNotifyCloseAfComplete

ProtocolCmOpenAf

ProtocolUnbindAdapterEx