Compartilhar via


Função phoneGetDevCaps (tapi.h)

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.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

PHONECAPS

Funções complementares do Serviço de Telefonia

Visão geral da referência do TAPI 2.2

Phonenegotiateapiversion

phoneNegotiateExtVersion