função TSPI_phoneGetDevCaps (tspi.h)
A função TSPI_phoneGetDevCaps consulta um dispositivo de telefone especificado para determinar seus recursos de telefonia.
Sintaxe
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
Parâmetros
dwDeviceID
O dispositivo de telefone a ser consultado.
dwTSPIVersion
O número de versão do TSPI negociado. Esse valor é negociado para esse dispositivo por meio da função TSPI_phoneNegotiateTSPIVersion .
dwExtVersion
O número de versão da extensão negociada. Esse valor é negociado para esse dispositivo por meio da função TSPI_phoneNegotiateExtVersion .
lpPhoneCaps
Um ponteiro para a memória na qual o provedor de serviços grava uma estrutura de tamanho variavelmente do tipo PHONECAPS. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações de funcionalidade do dispositivo de telefone. Antes de chamar TSPI_phoneGetDevCaps, o aplicativo define o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Comentários
O provedor de serviços preenche todos os membros da estrutura de dados PHONEBUTTONINFO , exceto dwTotalSize, que é preenchido pelo TAPI. O provedor de serviços não deve substituir o membro dwTotalSize .
Se dwExtVersion for zero, nenhuma informação de extensão será solicitada. Se for diferente de zero, ele conterá um valor que já foi negociado para esse dispositivo com a função TSPI_phoneNegotiateExtVersion . O provedor de serviços preenche informações estendidas específicas do dispositivo e do fornecedor de acordo com a versão de extensão especificada.
Depois que o provedor de serviços retorna da função TSPI_phoneGetDevCaps , TAPI define o membro dwPhoneStates da estrutura PHONECAPS da seguinte maneira:
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |