Função phoneGetDevCapsA (tapi.h)

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

Sintaxe

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

Parâmetros

hPhoneApp

Manipule 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 ordem baixa 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á ser deixado 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 ordem baixa 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 de retorno

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados 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.

Observações

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ões 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.

Nota

O cabeçalho tapi.h define phoneGetDevCaps como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

PHONECAPS

funções de serviço telefônico suplementar

visão geral de referência do TAPI 2.2

phoneNegotiateAPIVersion

phoneNegotiateExtVersion