função TSPI_phoneOpen (tspi.h)
A função TSPI_phoneOpen abre o dispositivo de telefone cujo identificador de dispositivo é dado, retornando o identificador opaco do provedor de serviços para o dispositivo e retendo o identificador opaco da TAPI para o dispositivo para uso em chamadas subsequentes ao procedimento PHONEEVENT .
Sintaxe
LONG TSPIAPI TSPI_phoneOpen(
DWORD dwDeviceID,
HTAPIPHONE htPhone,
LPHDRVPHONE lphdPhone,
DWORD dwTSPIVersion,
PHONEEVENT lpfnEventProc
);
Parâmetros
dwDeviceID
O dispositivo de telefone a ser aberto.
htPhone
O identificador opaco TAPI para o dispositivo de telefone a ser usado em chamadas subsequentes para o procedimento de retorno de chamada PHONEEVENT para identificar o dispositivo.
lphdPhone
Um ponteiro para um HDRVPHONE em que o provedor de serviços grava seu identificador para o dispositivo de telefone a ser usado pelo TAPI em chamadas subsequentes para identificar o dispositivo.
dwTSPIVersion
A versão TSPI negociada por meio de TSPI_phoneNegotiateTSPIVersion sob a qual o provedor de serviços pode operar.
lpfnEventProc
Um ponteiro para o procedimento de retorno de chamada PHONEEVENT fornecido pelo TAPI que o provedor de serviços chama para relatar eventos subsequentes no telefone.
Valor retornado
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INIFILECORRUPT.
Comentários
Abrir um telefone dá direito a TAPI para fazer mais solicitações no telefone. O telefone se torna ativo no sentido de que o provedor de serviços pode relatar eventos assíncronos, como alterações de gancho ou pressionamentos de botão. O provedor de serviços reserva todos os recursos nãoharáveis necessários para gerenciar o telefone. Por exemplo, abrir um telefone acessado por meio de uma porta de comm e modem deve resultar na abertura da porta de comm, tornando-a não mais disponível para uso por outros aplicativos.
Se a função for bem-sucedida, o TAPI e o provedor de serviços se comprometerão a operar sob o número de versão da interface especificado para este dispositivo aberto. Operações e eventos subsequentes identificados usando as alças de telefone opacas trocadas estão em conformidade com essa versão da interface. Esse compromisso e a validade dos identificadores permanecem em vigor até que o TAPI feche o telefone usando TSPI_phoneClose ou até que o provedor de serviços reporte o evento PHONE_CLOSE . Se a função não for bem-sucedida, nenhum compromisso desse tipo será feito e os identificadores não serão válidos.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |