função TSPI_providerCreatePhoneDevice (tspi.h)
A função TSPI_providerCreatePhoneDevice é chamada pelo TAPI em resposta ao recebimento de uma mensagem PHONE_CREATE do provedor de serviços, o que permite a criação dinâmica de um novo dispositivo de telefone.
Sintaxe
LONG TSPIAPI TSPI_providerCreatePhoneDevice(
DWORD_PTR dwTempID,
DWORD dwDeviceID
);
Parâmetros
dwTempID
O identificador de dispositivo temporário que o provedor de serviços passou para o TAPI na mensagem PHONE_CREATE .
dwDeviceID
O identificador de dispositivo que TAPI atribui a este dispositivo se essa função for bem-sucedida.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados de PHONEERR_ Constantes são:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED.
Comentários
Quando o TAPI recebe uma mensagem PHONE_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 identificador de dispositivo novo e 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 PHONE_CREATE como dwTempID. 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 parâmetro dwTempID e tiver êxito na configuração das estruturas e de modo que ele precise dar suporte ao novo dispositivo, ele salvará o 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 PHONE_CREATE será ignorada). Se essa função for concluída com êxito, a TAPI informará os aplicativos sobre a disponibilidade do novo dispositivo usando mensagens PHONE_CREATE ou PHONE_STATE (PHONESTATE_REINIT).
Os provedores de serviços mais antigos que não exportam essa função, no entanto, também não devem enviar mensagens PHONE_CREATE, o que significa que o TAPI não tentaria chamar essa função.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |