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