função TSPI_providerEnumDevices (tspi.h)

Artigo
03/13/2024

O TAPI chama a função TSPI_providerEnumDevices antes de TSPI_providerInit para determinar o número de dispositivos de linha e telefone compatíveis com o provedor de serviços.

Sintaxe

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

Parâmetros

dwPermanentProviderID

O identificador permanente, exclusivo dentro dos provedores de serviços nesse sistema, do provedor de serviços que está sendo inicializado.

lpdwNumLines

Um ponteiro para um local de memória do tamanho DWORD no qual o provedor de serviços deve gravar o número de dispositivos de linha que ele está configurado para dar suporte. O TAPI inicializa o valor como 0, portanto, se o provedor de serviços não gravar um valor diferente, o valor 0 será assumido.

lpdwNumPhones

Um ponteiro para um local de memória do tamanho DWORD no qual o provedor de serviços deve gravar o número de dispositivos de telefone que ele está configurado para dar suporte. O TAPI inicializa o valor como 0, portanto, se o provedor de serviços não gravar um valor diferente, o valor 0 será assumido.

hProvider

Um valor opaco do tamanho DWORD que identifica exclusivamente essa instância desse provedor de serviços durante essa execução do ambiente de telefonia.

lpfnLineCreateProc

Um ponteiro para o procedimento de retorno de chamada LINEEVENT fornecido pelo TAPI. O provedor de serviços usa essa função para enviar mensagens LINE_CREATE quando um novo dispositivo de linha precisa ser criado.

lpfnPhoneCreateProc

Um ponteiro para o procedimento de retorno de chamada PHONEEVENT fornecido pelo TAPI. O provedor de serviços usa essa função para enviar mensagens PHONE_CREATE quando um novo dispositivo de telefone precisa ser criado.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Comentários

Nas versões anteriores do TAPI, a implementação dessa função era opcional. A partir do TAPI 2.0, a implementação dessa função é obrigatória em todos os provedores de serviços. A TAPI não verifica mais Telephon.ini ou o Registro na inicialização do TAPI para determinar o número inicial de linhas e telefones compatíveis com um provedor de serviços.

Um novo dispositivo pode aparecer antes da conclusão do procedimento de TSPI_providerInit . O TAPI manipula corretamente todas as mensagens _CREATE durante a inicialização do provedor.