função TSPI_providerCreateLineDevice (tspi.h)

A função TSPI_providerCreateLineDevice é chamada pelo TAPI em resposta ao recebimento de uma mensagem de LINE_CREATE do provedor de serviços, o que permite a criação dinâmica de um novo dispositivo de linha.

Sintaxe

LONG TSPIAPI TSPI_providerCreateLineDevice(
  DWORD_PTR dwTempID,
  DWORD     dwDeviceID
);

Parâmetros

dwTempID

O identificador de dispositivo temporário que o provedor de serviços passou para TAPI na mensagem LINE_CREATE .

dwDeviceID

O identificador de dispositivo que o TAPI atribui a este dispositivo se essa função for bem-sucedida.

Valor retornado

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_BADDEVICEID, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Comentários

Quando o TAPI recebe uma mensagem LINE_CREATE de um provedor de serviços, ele chama essa função (ela nunca chama essa função espontaneamente). O TAPI adiciona 1 ao número de dispositivos desse tipo e passa o novo identificador de dispositivo não utilizado resultante como o parâmetro dwDeviceID para essa função. Ele também passa na função o parâmetro dwParam2 da mensagem LINE_CREATE como dwTempID.

Nota A adição do novo dispositivo ao final da lista de dispositivos provavelmente produzirá identificadores de dispositivo não contíguos para o provedor de serviços; os provedores de serviços que dão suporte à criação dinâmica de dispositivos também devem dar suporte a identificadores de dispositivo não contíguos.

 

Se o provedor de serviços reconhecer o dwTempID e tiver êxito na configuração das estruturas e de modo que ele precise dar suporte ao novo dispositivo, ele salvará a dwDeviceID e retornará SUCCESS. Se essa função não for bem-sucedida, o TAPI não adicionará o dispositivo e não haverá efeitos negativos (a mensagem LINE_CREATE será ignorada). Se essa função for concluída com êxito, o TAPI informará os aplicativos sobre a disponibilidade do novo dispositivo usando mensagens de LINE_CREATE ou LINE_LINEDEVSTATE (LINEDEVSTATE_REINIT).

Os provedores de serviços mais antigos que não exportam essa função, no entanto, também não devem enviar mensagens LINE_CREATE, o que significa que o TAPI não tentaria chamar essa função.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	tspi.h

Confira também

LINE_CREATE

LINE_LINEDEVSTATE