OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

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

Esse OID usa uma estrutura CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, que é definida da seguinte maneira:

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 dessa 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 CO_TAPI_FLAG_OUTGOING_CALL bit em ulFlags. Opcionalmente, o cliente pode definir o CO_TAPI_USE_DEFAULT_CALLPARAMS bit em ulFlags para 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 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 de 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 especificados 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 o driver MCM deve alocar a estrutura 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 em NdisCallParams.Length.

Se o cliente definir o CO_TAPI_USE_DEFAULT_CALLPARAMS bit em ulFlags, o cliente não especifica os parâmetros de chamada TAPI. Nesse caso, o gerenciador de chamadas ou o driver MCM devem 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ão retornar NDIS_STATUS_FAILURE.

Requisitos

Versão: Windows Vista e posterior Cabeçalho: Ntddndis.h (inclua Ndis.h)