NdisCmNotifyCloseAddressFamily 函数 (ndis.h)

项目
02/29/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 函数。微型端口呼叫管理器 (MMS) 改为调用 NdisMCmNotifyCloseAddressFamily 函数。

若要关闭绑定的 AF，独立调用管理器应从调用 NdisCmNotifyCloseAddressFamily ProtocolUnbindAdapterEx 函数。然后，NDIS 调用打开指定 AF 的客户端的 ProtocolClNotifyCloseAf 函数。

如果 NdisCmNotifyCloseAddressFamily 返回NDIS_STATUS_PENDING，则 NDIS 将调用调用管理器的客户端完成 AF 关闭操作后的 ProtocolCmNotifyCloseAfComplete 函数。

要求

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
目标平台	桌面
标头	ndis.h (包括 Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 符合性规则	Irql_CallManager_Function (ndis)