NdisClGetProtocolVcContextFromTapiCallId 函数 (ndis.h)
NdisClGetProtocolVcContextFromTapiCallId 检索由 TAPI 调用 ID 字符串标识的虚拟连接的客户端上下文。
语法
NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
[in] UNICODE_STRING TapiCallId,
[out] PNDIS_HANDLE ProtocolVcContext
);
参数
[in] TapiCallId
标识特定 VC 的 Unicode 字符串。 此字符串是以前由 NdisCoGetTapiCallID 函数返回的字符串标识符的 Unicode 版本。
[out] ProtocolVcContext
指向调用方分配的NDIS_HANDLE的指针,该NDIS_HANDLE接收 VC 客户端上下文的句柄。 客户端从其 ProtocolCoCreateVc 处理程序返回时,向 NDIS 提供了此上下文。
返回值
返回以下状态值之一:
返回代码 | 描述 |
---|---|
|
NDIS 已成功检索到由 TAPI 调用 ID 字符串标识的 VC 的客户端 VC 上下文的句柄。 |
|
尝试检索客户端 VC 上下文的句柄失败。 |
言论
假设呼叫管理器调用 NdisCoCreateVc 为 TAPI 呼叫创建 VC。 NDIS 反过来向客户端提供 VC 的句柄。 客户端在调用 NdisCoGetTapiCallId 函数中传递此 VC 句柄,以检索 VC 的字符串标识符。 然后,客户端可以将此标识符显示为 Unicode 字符串,以 NdisClGetProtocolVcContextFromTapiCallId 获取其 VC 的上下文。
客户端为它管理的每个 VC 创建一个上下文。 客户端使用 NdisCoGetTapiCallId 检索每个 VC 的字符串标识符。 客户端将每个字符串标识符传递给 TAPI 应用程序以标识每个 VC。 稍后,如果 TAPI 应用程序在与 VC 相关的作中将这些字符串标识符之一向下传递到客户端,则客户端必须在调用 NdisClGetProtocolVcContextFromTapiCallId 中将此字符串标识符作为 Unicode 字符串传递,以获取 VC 的正确上下文。
有关详细信息,请参阅 UNICODE_STRING 结构。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisClGetProtocolVcContextFromTapiCallId(NDIS 5.1)。 Windows XP 中支持 NDIS 5.1 驱动程序(请参阅 NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1) 。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | DISPATCH_LEVEL |
DDI 符合性规则 | Irql_Protocol_Driver_Function(ndis) |