Función NdisCoGetTapiCallId (ndis.h)
NdisCoGetTapiCallId recupera una cadena que las aplicaciones TAPI pueden usar para identificar una conexión virtual NDIS determinada (VC).
Sintaxis
NDIS_STATUS NdisCoGetTapiCallId(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PVAR_STRING TapiCallId
);
Parámetros
[in] NdisVcHandle
Especifica el identificador NDIS para el VC. NDIS proporcionó este identificador cuando el VC se creó originalmente con la función NdisCoCreateVc.
[in, out] TapiCallId
Puntero a un búfer asignado por el autor de la llamada que recibe una estructura de datos de tipo VAR_STRING. Tras la devolución correcta, esta estructura describe una cadena que las aplicaciones TAPI pueden usar para identificar la credencial verificable.
Valor devuelto
Devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
NDIS devolvió correctamente un identificador de cadena para la credencial verificable. |
|
El miembro ulTotalSize de la estructura VAR_STRING especifica que el tamaño del búfer no es lo suficientemente grande como para contener la cadena que identifica la credencial verificable. NdisCoGetTapiCallId establece el ulNeededSize miembro de la estructura de VAR_STRING en bytes. |
|
El identificador del VC especificado por NdisVcHandle no es válido. |
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 una cadena que identifica la credencial verificable. El cliente puede pasar este identificador de cadena a una aplicación TAPI para identificar 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.
Para obtener más información sobre la estructura de VAR_STRING, vea objetos TAPI.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCoGetTapiCallId (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisCoGetTapiCallId (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_Connection_Function(ndis) |