Inicialização do CoNDIS TAPI

Esta seção discute como um driver de miniporta WAN CoNDIS enumera seus recursos TAPI para aplicativos. Esses recursos TAPI consistem em:

• Número de dispositivos de linha suportados pelo driver de miniporta - os dispositivos de linha incluem, por exemplo, um modem, uma placa de fax e uma placa ISDN.

• Informações para linhas específicas - as informações de linha incluem, por exemplo, um identificador de linha e o número de endereços de canal (números de telefone) que a linha suporta para transmissão simultânea de voz e dados.

• Informações para endereços de canais específicos em linhas de dispositivos - as informações de endereço incluem, por exemplo, a identidade de um chamador (identificador de chamada) e o número de chamadas ativas possíveis.

Para recuperar informações sobre hardware subjacente, o NDPROXY emite solicitações para recursos de linha e endereço de canal. Ou seja, o driver NDPROXY consulta os recursos TAPI de um driver de miniporta CoNDIS WAN. O driver NDPROXY chama a função NdisCoOidRequest para consultar os recursos TAPI do driver de miniporta. Nesta chamada, NDPROXY passa uma estrutura NDIS_OID_REQUEST. NDPROXY especifica o seguinte em NDIS_OID_REQUEST:

• Valor NdisRequestQueryInformation no membro RequestType

• Identificador de objeto (OID) que especifica a capacidade TAPI a recuperar a partir do driver de miniporta no membro Oid

• Buffer para armazenar as informações de capacidade TAPI retornadas no membro InformationBuffer

Todas as consultas feitas para um driver de miniporta CoNDIS WAN pelo driver NDPROXY podem ser concluídas sincronamente ou assincronamente. Se um driver de miniporta WAN CoNDIS determinar que ele não pode concluir a consulta imediatamente, então ele pode simplesmente retornar NDIS_STATUS_PENDING e chamar a função NdisMCmOidRequestComplete de dentro de sua função ProtocolCoOidRequest quando tiver concluído a consulta.

Depois que um driver de miniporta CoNDIS WAN notifica o NDPROXY sobre o registro de uma nova família de endereços, conforme especificado no Registro CoNDIS TAPI, o NDPROXY consulta os seguintes OIDs para determinar os recursos específicos de TAPI do driver de miniporta CoNDIS WAN e a NIC do driver de miniporta.

• NDPROXY consulta o driver de miniporta com OID_CO_TAPI_CM_CAPS para determinar o número de linhas suportadas pelo dispositivo do driver de miniporta (o dispositivo para o qual ele fornece serviços TAPI). Este OID também solicita que o driver de miniporta indique se essas linhas têm recursos de linha diferentes.

• Em seguida, o NDPROXY consulta o driver de miniporta com OID_CO_TAPI_LINE_CAPS para determinar os recursos de telefonia para a linha especificada. Esse OID também solicita que o driver de miniporta indique se os endereços nessa linha têm capacidades de endereço distintas.

  • Se a consulta anterior de OID_CO_TAPI_CM_CAPS indicou que o dispositivo do driver de miniporta suporta apenas uma linha, ou se o dispositivo suporta várias linhas que têm as mesmas capacidades de linha, NDPROXY tem que consultar OID_CO_TAPI_LINE_CAPS apenas uma vez para obter as capacidades de linha do dispositivo. Nesse caso, os recursos de linha retornados pelo driver de miniporta se aplicam a todas as linhas do dispositivo.
  • Se o dispositivo suportar várias linhas com recursos de linha diferentes, o NDPROXY deverá consultar OID_CO_TAPI_LINE_CAPS uma vez para cada linha para obter os recursos de linha de cada linha.

• Finalmente, o NDPROXY consulta o driver de miniporta com OID_CO_TAPI_ADDRESS_CAPS para determinar os recursos de telefonia para um endereço especificado em uma linha especificada.

  • Se a consulta anterior de OID_CO_TAPI_LINE_CAPS indicar que a linha suporta apenas um endereço ou que todos os endereços na linha têm as mesmas capacidades de endereço, o NDPROXY consulta OID_CO_TAPI_ADDRESS_CAPS apenas uma vez para determinar as capacidades de todos os endereços na linha.
  • Se uma linha oferecer suporte a vários endereços que tenham capacidades diferentes, o NDPROXY consulta o OID_CO_TAPI_ADDRESS_CAPS uma vez para cada endereço na linha.

O driver NDPROXY usa as informações obtidas com os OIDs de enumeração TAPI para fazer o seguinte:

• Crie parâmetros TAPI para chamadas TAPI subsequentes.

• Determine se deseja aceitar ou rejeitar chamadas TAPI de entrada subsequentes.

• Registre um ou mais pontos de acesso de serviço TAPI (SAPs) nos quais receber chamadas TAPI de entrada subsequentes.