OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

El OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID solicita un administrador de llamadas o un controlador de miniporte integrado (MCM) para traducir parámetros de llamada TAPI a parámetros de llamada NDIS. El cliente que consulta este OID usa los parámetros de llamada de NDIS devueltos como entrada (con formato como una estructura de CO_CALL_PARAMETERS ) a NdisClMakeCall, con el que el cliente realiza una llamada saliente.

Este OID usa una estructura de CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, que se define de la siguiente manera:

typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
    IN  ULONG               ulLineID;
    IN  ULONG               ulAddressID;
    IN  ULONG               ulFlags;
    IN  NDIS_VAR_DATA_DESC  DestAddress;
    IN  NDIS_VAR_DATA_DESC  LineCallParams;
    OUT NDIS_VAR_DATA_DESC  NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;

Los miembros de esta estructura contienen la siguiente información:

ulLineID
Especifica un identificador de línea de base cero al que se dirigirá la llamada saliente.

ulAddressID
Especifica un identificador de dirección de base cero (en la línea especificada por ulLineID) a la que se dirigirá la llamada saliente.

ulFlags
El cliente debe establecer el bit de CO_TAPI_FLAG_OUTGOING_CALL en ulFlags. Opcionalmente, el cliente puede establecer el bit de CO_TAPI_USE_DEFAULT_CALLPARAMS en ulFlags para requerir que el administrador de llamadas o el controlador MCM ignoren LineCallParams y devuelvan los parámetros de llamada NDIS predeterminados para el dispositivo.

DestAddress
Especifica una estructura de NDIS_VAR_DATA_DESC que contiene un desplazamiento desde el principio de la estructura de NDIS_VAR_DATA_DESC a una dirección de destino con formato de matriz de caracteres. La estructura NDIS_VAR_DATA_DESC también contiene la longitud de la dirección de destino. La dirección de destino es la dirección a la que se dirigirá la llamada saliente.

LineCallParams
Especifica una estructura de NDIS_VAR_DATA_DESC que contiene un desplazamiento desde el principio de la estructura de NDIS_VAR_DATA_DESC a una estructura de LINE_CALL_PARAMS. La estructura NDIS_VAR_DATA_DESC también contiene la longitud de la estructura LINE_CALL_PARAMS. La estructura LINE_CALL_PARAMS especifica los parámetros de llamada TAPI que se van a traducir en parámetros de llamada NDIS. Para obtener más información sobre la estructura de LINE_CALL_PARAMS, vea el Microsoft Windows SDK y el archivo de encabezado ndistapi.h.

NdisCallParams
Especifica una estructura de NDIS_VAR_DATA_DESC que contiene un desplazamiento desde el principio de la estructura de NDIS_VAR_DATA_DESC a una estructura de CO_CALL_PARAMETERS. La estructura NDIS_VAR_DATA_DESC también contiene la longitud de la estructura CO_CALL_PARAMETERS . La estructura CO_CALL_PARAMETERS especifica los parámetros de llamada NDIS en los que se han traducido los parámetros de llamada TAPI especificados.

Observaciones

Si la solicitud se realiza correctamente, el administrador de llamadas o el controlador MCM rellena la estructura de CO_CALL_PARAMETERS a la que hace referencia NdisCallParams con los parámetros de llamada NDIS traducidos. El administrador de llamadas o el controlador MCM deben asignar la estructura de CO_CALL_PARAMETERS dentro de la sección de memoria plana a la que hace referencia NdisCallParams. El cliente escribe la longitud total de la estructura de CO_CALL_PARAMETERS en NdisCallParams.Length.

Si el cliente establece el bit de CO_TAPI_USE_DEFAULT_CALLPARAMS en ulFlags, el cliente no especifica parámetros de llamada TAPI. En este caso, el administrador de llamadas o el controlador MCM deben devolver los parámetros de llamada NDIS predeterminados para el dispositivo. Si no hay ningún parámetro de llamada NDIS predeterminado para el dispositivo, el administrador de llamadas o el controlador MCM deben devolver NDIS_STATUS_FAILURE.

Requisitos

Versión: Windows Vista y encabezado posterior: Ntddndis.h (incluya Ndis.h)