NdisMCmOpenAddressFamilyComplete 宏 (ndis.h)

NdisMCmOpenAddressFamilyComplete 返回客户端请求的最终状态,其中 MCM 驱动程序的 ProtocolCmOpenAf 函数返回NDIS_STATUS_PENDING,以打开 MCM 驱动程序的地址系列。

语法

void NdisMCmOpenAddressFamilyComplete(
   _S_,
   _H_,
   _C_
);

参数

_S_

指定客户端请求打开 AF 的最终状态,NDIS_STATUS_SUCCESS或任何调用方确定NDIS_STATUS_ XXX,NDIS_STATUS_PENDING除外。

_H_

指定向 MCM 驱动程序的 protocolCmOpenAf 函数输入的 NDIS 提供的句柄,该函数返回NDIS_STATUS_PENDING。

_C_

指定调用方分配的驻地上下文区域的句柄,如果打开成功,MCM 驱动程序会保留有关此客户端打开地址系列的状态,包括 NdisAfHandle。 否则,NDIS 将忽略此参数。

返回值

没有

言论

MCM 驱动程序必须调用 NdisMCmOpenAddressFamilyComplete(如果其 ProtocolCmOpenAf 函数之前为给定的 NdisAfHandle 返回NDIS_STATUS_PENDING)。 客户端通过调用 NdisClOpenAddressFamilyEx启动笔式 open-AF作,在 NdisMCmOpenAddressFamilyComplete 导致对该客户端的调用导致对该客户端的调用之前,客户端无法对同一绑定执行进一步的连接导向作 ProtocolClOpenAfCompleteEx 函数。

如果 NdisMCmOpenAddressFamilyComplete 的调用方状态 设置为 NDIS_STATUS_SUCCESS, NDIS 随后将给定的 CallMgrAfContext 句柄作为输入参数传递给所有 MCM 驱动程序提供的 ProtocolCmXxx 和 ProtocolCoXxx 函数,这些函数涉及客户端打开地址系列,直到客户端关闭 AF。 MCM 驱动程序应在将失败状态传递给 NdisMCmOpenAddressFamilyComplete之前释放或重复使用它分配的任何 AF 上下文区域。

对于成功的打开,NDIS 提供的 NdisAfHandle 表示打开的 AF 的 MCM 驱动程序与客户端之间的关联。 在随后调用 NdisCl/Co/Co/MCm/MCoXxx 函数时,两个 NDIS 驱动程序必须将 NdisAfHandle 视为要传递、未修改和未解释的不透明变量。 对于打开失败,MCM 驱动程序应考虑当 NdisMCmOpenAddressFamilyComplete 返回控件时,NdisAfHandle 无效。

只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才能调用 NdisMCmOpenAddressFamilyComplete。 独立呼叫管理器,将其注册为协议驱动程序的 NDIS,请改为调用 NdisCmOpenAddressFamilyComplete

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisMCmOpenAddressFamilyComplete (NDIS 5.1) 。 支持 NDIS 5.1 驱动程序(请参阅 Windows XP 中的 NdisMCmOpenAddressFamilyComplete (NDIS 5.1)。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_MCM_Function(ndis)

另请参阅

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf