Compartilhar via

OID_CO_TAPI_LINE_CAPS

  • Artigo

O OID_CO_TAPI_LINE_CAPS OID solicita um gerenciador de chamadas ou um driver MCM (gerenciador de chamadas de miniporto) integrado para retornar os recursos de telefonia para uma linha especificada. Esse OID também solicita que o gerenciador de chamadas ou o driver MCM indique se os endereços nessa linha têm funcionalidades de telefonia diferentes.

Essa solicitação usa uma estrutura de CO_TAPI_LINE_CAPS, definida da seguinte maneira, para consultar os recursos de telefonia de uma linha especificada:

typedef struct _CO_TAPI_LINE_CAPS {
    IN  ULONG           ulLineID;
    OUT ULONG           ulFlags;
    OUT LINE_DEV_CAPS   LineDevCaps;
} CO_TAPI_LINE_CAPS, *PCO_TAPI_LINE_CAPS;

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

ulLineID
Especifica a linha para a qual os recursos de telefonia devem ser retornados. ulLineID é um identificador baseado em zero.

ulFlags
Se a linha der suporte a vários endereços com funcionalidades de telefonia diferentes, o gerenciador de chamadas ou o driver MCM definirá o CO_TAPI_FLAG_PER_ADDRESS_CAPS bit em ulFlags; caso contrário, o gerenciador de chamadas ou o driver MCM limpará esse bit. Todos os bits indefinidos são reservados e devem ser definidos como 0.

Linedevcaps
Especifica as funcionalidades de telefonia de uma linha, formatadas como uma estrutura LINE_DEV_CAPS. Para obter mais informações sobre essa estrutura, consulte o SDK do Microsoft Windows e o arquivo de cabeçalho ndistapi.h.

Comentários

Depois de consultar os recursos de telefonia do dispositivo de um gerenciador de chamadas ou do driver MCM com OID_CO_TAPI_CM_CAPS, um cliente orientado à conexão consulta os recursos de telefonia das linhas com suporte do dispositivo.

  • Se todas as linhas compatíveis com o dispositivo tiverem os mesmos recursos de linha e todos os endereços nessas linhas tiverem os mesmos recursos de endereço, as consultas de cliente OID_CO_TAPI_LINE_CAPS uma vez para obter os recursos de linha do dispositivo. Nesse caso, os recursos de linha retornados pelo gerenciador de chamadas ou pelo driver MCM se aplicam a todas as linhas compatíveis com o dispositivo.
  • No entanto, se o dispositivo der suporte a várias linhas com funcionalidades diferentes e/ou se os endereços nessas linhas tiverem funcionalidades de endereço diferentes, as consultas de cliente OID_CO_TAPI_LINE_CAPS uma vez para cada linha com suporte do dispositivo para obter os recursos de cada linha.

A configuração ulFlags determina quantas vezes o cliente consulta subsequentemente os recursos dos endereços na linha:

  • Se a linha der suporte a apenas um endereço ou se a linha der suporte a vários endereços que têm os mesmos recursos de endereço, as consultas do cliente OID_CO_TAPI_ADDRESS_CAPS uma vez.
  • Se a linha der suporte a vários endereços que têm funcionalidades diferentes, o cliente deverá consultar OID_CO_TAPI_ADDRESS_CAPS uma vez para cada endereço na linha.

Requisitos

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