NdisMCmRegisterSapComplete 宏 (ndis.h)
NdisMCmRegisterSapComplete 返回客户端请求的最终状态,MCM 驱动程序的
以前返回的 ProtocolCmRegisterSap 函数NDIS_STATUS_PENDING,用于注册 SAP。
语法
void NdisMCmRegisterSapComplete(
_S_,
_H_,
_C_
);
参数
_S_
指定客户端注册 SAP 的原始请求的最终状态,NDIS_STATUS_SUCCESS或任何调用方确定NDIS_STATUS_XXX(NDIS_STATUS_PENDING除外 )。
_H_
指定注册成功时向 SAP 提供的 NDIS 句柄。 调用管理器获取此句柄作为其 ProtocolCmRegisterSap 函数的输入参数。
_C_
指定调用方提供的常驻上下文区域的句柄,如果注册成功,MCM 驱动程序在该区域中维护此 SAP 的状态。 如果是这样,NDIS 会在有关此 SAP 的所有后续调用中将此句柄传递回 MCM 驱动程序。 如果 Status 设置为除 NDIS_STATUS_SUCCESS 之外的其他值,NDIS 将忽略此参数。
返回值
无
备注
如果 MCM 驱动程序的 ProtocolCmRegisterSap 函数在使用给定的 NdisSapHandle 调用时返回NDIS_STATUS_PENDING,则必须调用 NdisMCmRegisterSapComplete。 调用 NdisMCmRegisterSapComplete 会导致 NDIS 调用客户端的 ProtocolClRegisterSapComplete 函数。
如果 MCM 驱动程序将“状态”设置为除NDIS_STATUS_SUCCESS以外的任何内容,则当 NdisMCmRegisterSapComplete 返回控件时,它应将 NdisSapHandle 视为无效。 在 SAP 注册失败后,CM 可以释放或重复使用已分配的每个 SAP 上下文区域(如果有)。 如果 MCM 驱动程序注册失败,NDIS 还会发布 SAP 的上下文。
只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才能调用 NdisMCmRegisterSapComplete。 独立调用管理器(将自己注册到 NDIS 作为协议驱动程序)改为调用 NdisCmRegisterSapComplete 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 支持 NDIS 6.0 和 NDIS 5.1 驱动程序 (请参阅 Windows Vista 中的 NdisMCmRegisterSapComplete (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisMCmRegisterSapComplete (NDIS 5.1) ) 。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_MCM_Function (ndis) |