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 una vc determinada. Esta cadena es la versión Unicode de un identificador de cadena devuelto previamente por la función NdisCoGetTapiCallID .
[out] ProtocolVcContext
Puntero a un NDIS_HANDLE asignado por el autor de la llamada que recibe un identificador para el contexto de cliente para la credencial verificable. El cliente proporcionó este contexto a NDIS de vuelta desde su controlador ProtocolCoCreateVc .
Valor devuelto
Devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
NDIS recuperó correctamente el identificador para el 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. |
Comentarios
Supongamos que un administrador de llamadas llama a NdisCoCreateVc para crear un VC para una llamada TAPI. A su vez, NDIS proporciona el identificador para la credencial verificable 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. A continuación, el cliente puede presentar este identificador como una cadena Unicode a NdisClGetProtocolVcContextFromTapiCallId para recuperar 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 credencial verificable.
Consulte la estructura UNICODE_STRING para obtener más información.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | 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. |
| Plataforma de destino | Escritorio |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | Irql_Protocol_Driver_Function(ndis) |