Función NdisClGetProtocolVcContextFromTapiCallId (ndis.h)
NdisClGetProtocolVcContextFromTapiCallId recupera el contexto de cliente de una conexión virtual (VC) identificada por una cadena de identificador de llamada TAPI.
Sintaxis
NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
[in] UNICODE_STRING TapiCallId,
[out] PNDIS_HANDLE ProtocolVcContext
);
Parámetros
[in] TapiCallId
Cadena Unicode que identifica un VC determinado. Esta cadena es la versión Unicode de un identificador de cadena que devolvió anteriormente la función NdisCoGetTapiCallID.
[out] ProtocolVcContext
Puntero a un NDIS_HANDLE asignado por el autor de la llamada que recibe un identificador al contexto de cliente para la credencial verificable. El cliente proporcionó este contexto a NDIS a cambio de su controlador de ProtocolCoCreateVc.
Valor devuelto
Devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
NDIS recuperó correctamente el identificador del contexto de VC del cliente para el VC identificado por la cadena de identificador de llamada TAPI. |
|
Error al intentar recuperar el identificador al contexto de VC del cliente. |
Observaciones
Supongamos que un administrador de llamadas llama a NdisCoCreateVc para crear un VC para una llamada TAPI. NDIS a su vez proporciona el identificador de vc a un cliente. El cliente pasa este identificador de VC en una llamada a la función NdisCoGetTapiCallId para recuperar un identificador de cadena para la credencial verificable. Después, el cliente puede presentar este identificador como una cadena Unicode para NdisClGetProtocolVcContextFromTapiCallId para obtener su contexto para la credencial verificable.
El cliente crea un contexto para cada VC que administra. El cliente usa NdisCoGetTapiCallId para recuperar un identificador de cadena para cada VC. El cliente pasa cada identificador de cadena a una aplicación TAPI para identificar cada VC. Más adelante, si una aplicación TAPI pasa uno de estos identificadores de cadena al cliente en una operación relacionada con VC, el cliente debe pasar este identificador de cadena como una cadena Unicode en una llamada a NdisClGetProtocolVcContextFromTapiCallId para obtener el contexto correcto para la vc.
Consulte la estructura UNICODE_STRING para obtener más información.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | Irql_Protocol_Driver_Function(ndis) |