Função phoneGetDevCaps (tapi.h)

Artigo
08/26/2023

A função phoneGetDevCaps consulta um dispositivo de telefone especificado para determinar seus recursos de telefonia.

Sintaxe

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parâmetros

hPhoneApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Identificador do dispositivo de telefone a ser consultado.

dwAPIVersion

Número de versão da API de Telefonia a ser usada. A palavra de alta ordem contém o número de versão principal; a palavra de baixa ordem contém o número de versão secundária. Esse número é obtido com a função phoneNegotiateAPIVersion.

dwExtVersion

Número de versão das extensões específicas do provedor de serviços a serem usadas. Esse número é obtido com a função phoneNegotiateExtVersion. Ele poderá ficar zero se nenhuma extensão específica do dispositivo for usada. Caso contrário, a palavra de alta ordem contém o número de versão principal; a palavra de baixa ordem contém o número de versão secundária.

lpPhoneCaps

Ponteiro para 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 funcionalidades do dispositivo de telefone.

Valor retornado

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

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Comentários

Antes de usar phoneGetDevCaps, o aplicativo deve negociar o número de versão TAPI a ser usado (consulte phoneNegotiateAPIVersion) e, opcionalmente, a versão de extensão a ser usada (consulte phoneNegotiateExtVersion).

TAPI e números de versão de extensão são aqueles sob os quais TAPI, DLL de telefonia e provedor de serviços devem operar. Se os intervalos de versão não se sobrepõem, as versões do aplicativo e da API ou do provedor de serviços serão incompatíveis e um erro será retornado.