OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

O OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID solicita um gerenciador de chamadas ou um driver de miniporta (MCM) integrado do gerenciador de chamadas para traduzir parâmetros de chamada TAPI para parâmetros de chamada NDIS. O cliente que consulta este OID usa os parâmetros de chamada NDIS retornados como uma entrada (formatada como uma estrutura CO_CALL_PARAMETERS) para NdisClMakeCall, com o qual o cliente faz uma chamada de saída.

Este OID usa uma estrutura CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, que é definida da seguinte forma:

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;

Os membros desta estrutura contêm as seguintes informações:

ulLineID
Especifica um identificador de linha baseado em zero para o qual a chamada de saída será direcionada.

ulAddressID
Especifica um identificador de endereço baseado em zero (na linha especificada por ulLineID) para o qual a chamada de saída será direcionada.

ulFlags
O cliente deve definir o bit de CO_TAPI_FLAG_OUTGOING_CALL em ulFlags. O cliente pode, opcionalmente, definir o bit de CO_TAPI_USE_DEFAULT_CALLPARAMS em ulFlags exigir que o gerenciador de chamadas ou o driver MCM ignore o LineCallParams e retorne os parâmetros de chamada NDIS padrão para o dispositivo.

DestAddress
Especifica uma estrutura NDIS_VAR_DATA_DESC que contém um deslocamento do início da estrutura NDIS_VAR_DATA_DESC para um endereço de destino formatado como uma matriz de caracteres. A estrutura NDIS_VAR_DATA_DESC também contém o comprimento do endereço de destino. O endereço de destino é o endereço para o qual a chamada de saída será direcionada.

LineCallParams
Especifica uma estrutura de NDIS_VAR_DATA_DESC que contém um deslocamento do início da estrutura NDIS_VAR_DATA_DESC para uma estrutura LINE_CALL_PARAMS. A estrutura NDIS_VAR_DATA_DESC também contém o comprimento da estrutura LINE_CALL_PARAMS. A estrutura LINE_CALL_PARAMS especifica os parâmetros de chamada TAPI a serem convertidos em parâmetros de chamada NDIS. Para obter mais informações sobre a estrutura LINE_CALL_PARAMS, consulte o SDK do Microsoft Windows e o arquivo de cabeçalho ndistapi.h.

NdisCallParams
Especifica uma estrutura NDIS_VAR_DATA_DESC que contém um deslocamento do início da estrutura NDIS_VAR_DATA_DESC para uma estrutura CO_CALL_PARAMETERS. A estrutura NDIS_VAR_DATA_DESC também contém o comprimento da estrutura CO_CALL_PARAMETERS. A estrutura CO_CALL_PARAMETERS especifica os parâmetros de chamada NDIS nos quais os parâmetros de chamada TAPI fornecidos foram traduzidos.

Comentários

Se a solicitação for bem-sucedida, o gerenciador de chamadas ou o driver MCM preencherá a estrutura de CO_CALL_PARAMETERS referenciada por NdisCallParams com os parâmetros de chamada NDIS traduzidos. O gerenciador de chamadas ou driver MCM deve alocar a estrutura de CO_CALL_PARAMETERS dentro da seção de memória plana referida por NdisCallParams. O cliente grava o comprimento total da estrutura CO_CALL_PARAMETERS para NdisCallParams.Length.

Se o cliente definir o bit de CO_TAPI_USE_DEFAULT_CALLPARAMS em ulFlags, o cliente não especificará parâmetros de chamada TAPI. Nesse caso, o gerenciador de chamadas ou o driver MCM deve retornar os parâmetros de chamada NDIS padrão para o dispositivo. Se não houver parâmetros de chamada NDIS padrão para o dispositivo, o gerenciador de chamadas ou o driver MCM deverá retornar NDIS_STATUS_FAILURE.

Requerimentos

Versão: Windows Vista e posterior de cabeçalho : Ntddndis.h (incluir Ndis.h)