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

2025-02-07

Функция 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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_CallManager_Function(ndis)