Estrutura PHONECAPS (tapi.h)

Artigo
08/26/2023

A estrutura PHONECAPS descreve os recursos de um dispositivo de telefone. As funções phoneGetDevCaps e TSPI_phoneGetDevCaps retornam essa estrutura.

Sintaxe

typedef struct phonecaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwProviderInfoSize;
  DWORD dwProviderInfoOffset;
  DWORD dwPhoneInfoSize;
  DWORD dwPhoneInfoOffset;
  DWORD dwPermanentPhoneID;
  DWORD dwPhoneNameSize;
  DWORD dwPhoneNameOffset;
  DWORD dwStringFormat;
  DWORD dwPhoneStates;
  DWORD dwHookSwitchDevs;
  DWORD dwHandsetHookSwitchModes;
  DWORD dwSpeakerHookSwitchModes;
  DWORD dwHeadsetHookSwitchModes;
  DWORD dwVolumeFlags;
  DWORD dwGainFlags;
  DWORD dwDisplayNumRows;
  DWORD dwDisplayNumColumns;
  DWORD dwNumRingModes;
  DWORD dwNumButtonLamps;
  DWORD dwButtonModesSize;
  DWORD dwButtonModesOffset;
  DWORD dwButtonFunctionsSize;
  DWORD dwButtonFunctionsOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwNumSetData;
  DWORD dwSetDataSize;
  DWORD dwSetDataOffset;
  DWORD dwNumGetData;
  DWORD dwGetDataSize;
  DWORD dwGetDataOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwPhoneFeatures;
  DWORD dwSettableHandsetHookSwitchModes;
  DWORD dwSettableSpeakerHookSwitchModes;
  DWORD dwSettableHeadsetHookSwitchModes;
  DWORD dwMonitoredHandsetHookSwitchModes;
  DWORD dwMonitoredSpeakerHookSwitchModes;
  DWORD dwMonitoredHeadsetHookSwitchModes;
  GUID  PermanentPhoneGuid;
} PHONECAPS, *LPPHONECAPS;

Membros

dwTotalSize

Tamanho total alocado para essa estrutura de dados, em bytes.

dwNeededSize

Tamanho para essa estrutura de dados necessária para armazenar todas as informações retornadas, em bytes.

dwUsedSize

Tamanho da parte dessa estrutura de dados que contém informações úteis, em bytes.

dwProviderInfoSize

Tamanho das informações específicas do provedor, em bytes. Se as informações específicas do provedor forem um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

dwProviderInfoOffset

Deslocamento do início da estrutura para o campo de tamanho variável que contém informações específicas do provedor de serviços.

Esse membro fornece informações sobre o hardware e/ou software do provedor, como o nome do fornecedor e os números de versão de hardware e software. Essas informações podem ser úteis quando um usuário precisa chamar o atendimento ao cliente com problemas relacionados ao provedor. O tamanho do campo é especificado por dwProviderInfoSize.

dwPhoneInfoSize

Tamanho das informações específicas do telefone, em bytes. Se as informações específicas do telefone forem um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

dwPhoneInfoOffset

Deslocamento do início da estrutura para o campo de dispositivo de tamanho variável que contém informações específicas do telefone.

Esse membro fornece informações sobre o dispositivo de telefone anexado, como o fabricante do dispositivo de telefone, o nome do modelo, a versão do software e assim por diante. Essas informações podem ser úteis quando um usuário precisa ligar para o atendimento ao cliente com problemas relacionados ao telefone. O tamanho do campo é especificado por dwPhoneInfoSize.

dwPermanentPhoneID

Identificador permanente pelo qual o dispositivo de telefone é conhecido na configuração do sistema.

dwPhoneNameSize

Tamanho do nome configurável para o telefone, incluindo o terminador nulo , em bytes.

dwPhoneNameOffset

Deslocamento do início da estrutura para o campo de dispositivo de tamanho variável que contém um nome configurável pelo usuário para este dispositivo de telefone. Esse nome pode ser configurado pelo usuário ao configurar o provedor de serviços do dispositivo de telefone e é fornecido para a conveniência do usuário. O tamanho do campo é especificado por dwPhoneNameSize.

dwStringFormat

Formato de cadeia de caracteres a ser usado com este dispositivo de telefone. Esse membro usa uma das constantes STRINGFORMAT_.

dwPhoneStates

Alterações de estado para este dispositivo de telefone para o qual o aplicativo pode ser notificado em uma mensagem de PHONE_STATE . Este membro é uma ou mais das constantes PHONESTATE_.

dwHookSwitchDevs

Dispositivos hookswitch do telefone. Esse membro usa uma das constantes PHONEHOOKSWITCHDEV_.

dwHandsetHookSwitchModes

Modo hookswitch do aparelho. O membro só será significativo se o dispositivo hookswitch estiver listado em dwHookSwitchDevs. Ele usa uma das constantes PHONEHOOKSWITCHMODE_.

dwSpeakerHookSwitchModes

Modo Hookswitch do alto-falante. O membro só será significativo se o dispositivo hookswitch estiver listado em dwHookSwitchDevs. Ele usa uma das constantes PHONEHOOKSWITCHMODE_.

dwHeadsetHookSwitchModes

Modo hookswitch do headset. O membro só será significativo se o dispositivo hookswitch estiver listado em dwHookSwitchDevs. Ele usa uma das constantes PHONEHOOKSWITCHMODE_.

dwVolumeFlags

Funcionalidades de configuração de volume dos componentes do alto-falante do dispositivo de telefone. Se o bit na posição PHONEHOOKSWITCHDEV_ for TRUE, o volume do componente do alto-falante do dispositivo hookswitch correspondente poderá ser ajustado com phoneSetVolume.

dwGainFlags

Funcionalidades de configuração de ganho dos componentes de microfone do dispositivo de telefone. Se a posição do bit PHONEHOOKSWITCHDEV_ for TRUE, o volume do componente de microfone do dispositivo hookswitch correspondente poderá ser ajustado com phoneSetGain.

dwDisplayNumRows

Exibir funcionalidades do dispositivo de telefone descrevendo o número de linhas na tela do telefone. Os membros dwDisplayNumRows e dwDisplayNumColumns são zero para um dispositivo de telefone sem exibição.

dwDisplayNumColumns

Exiba os recursos do dispositivo de telefone descrevendo o número de colunas na tela do telefone. Os membros dwDisplayNumRows e dwDisplayNumColumns são zero para um dispositivo de telefone sem exibição.

dwNumRingModes

Funcionalidades de toque do dispositivo de telefone. O telefone é capaz de tocar com padrões de anel diferentes dwNumRingModes , identificados como 1, 2, por meio de dwNumRingModes menos um. Se o valor desse membro for 0, os aplicativos não terão controle sobre o modo de toque do telefone. Se o valor desse membro for maior que 0, ele indicará o número de modos de anel, além do silêncio com suporte do provedor de serviços. Um valor de 0 no parâmetro lpdwRingMode de phoneGetRing ou o parâmetro dwRingMode de phoneSetRing indica silêncio (o telefone não está tocando ou não deve ser tocado) e os valores dwRingMode de 1 a dwNumRingModes são modos de toque válidos para o dispositivo de telefone.

dwNumButtonLamps

Número de botões/lâmpadas no dispositivo de telefone detectáveis no TAPI. Botões/lâmpadas são identificados pelo identificador. Identificadores de botão/lâmpada válidos variam de zero a dwNumButtonLamps menos um. Os botões do teclado '0', até '9', '*' e '#' recebem os identificadores de 0 a 12.

dwButtonModesSize

Tamanho da matriz de modos de botão, em bytes.

dwButtonModesOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém os modos de botão dos botões do telefone. A matriz é indexada por identificador de botão/lâmpada. Essa matriz usa as constantes PHONEBUTTONMODE_. O tamanho da matriz é especificado por dwButtonModesSize.

dwButtonFunctionsSize

Tamanho do campo de funções de botão, em bytes.

dwButtonFunctionsOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém as funções de botão dos botões do telefone. A matriz é indexada por identificador de botão/lâmpada. Essa matriz usa as constantes PHONEBUTTONFUNCTION_. O tamanho da matriz é especificado por dwButtonFunctionsSize.

dwLampModesSize

Tamanho da matriz de modos de lâmpada, em bytes.

dwLampModesOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém os modos de lâmpada das lâmpadas do telefone. A matriz é indexada por identificador de botão/lâmpada. Essa matriz usa as constantes PHONELAMPMODE_. O tamanho da matriz é especificado por dwLampModesSize.

dwNumSetData

Número de diferentes áreas de download no dispositivo de telefone. As diferentes áreas são referidas usando as IDs de dados 0, 1, , dwNumSetData menos uma. Se esse membro for zero, o telefone não oferecerá suporte ao recurso de download.

dwSetDataSize

Tamanho da matriz de tamanho de dados, em bytes.

dwSetDataOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém os tamanhos (em bytes) das áreas de dados de download do telefone. Essa é uma matriz com elementos do tamanho DWORD indexados pelo identificador de dados. O tamanho da matriz é especificado por dwSetDataSize.

dwNumGetData

Número de diferentes áreas de carregamento no dispositivo de telefone. As diferentes áreas são referidas usando as IDs de dados 0, 1, , dwNumGetData menos uma. Se esse campo for zero, o telefone não oferecerá suporte à funcionalidade de upload.

dwGetDataSize

Tamanho da matriz de tamanho de dados, em bytes.

dwGetDataOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém os tamanhos (em bytes) das áreas de dados de upload do telefone. Essa é uma matriz com elementos do tamanho DWORD indexados pelo identificador de dados. O tamanho da matriz é especificado por dwGetDataSize.

dwDevSpecificSize

Tamanho do campo específico do dispositivo, em bytes. Se as informações específicas do dispositivo forem um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

dwDevSpecificOffset

Deslocamento do início dessa estrutura para o campo específico do dispositivo de tamanho variável. O tamanho do campo é especificado por dwDevSpecificSize.

dwDeviceClassesSize

Tamanho dos identificadores de classe de dispositivo com suporte, em bytes.

dwDeviceClassesOffset

Deslocamento do início dessa estrutura para uma cadeia de caracteres que consiste nos identificadores de classe de dispositivo com suporte neste dispositivo para uso com phoneGetID. Os identificadores são separados por NULLs e o último identificador na lista é seguido por dois NULLs. O tamanho do campo é especificado por dwDeviceClassesSize.

dwPhoneFeatures

Sinalizadores que indicam quais funções da API de Telefonia podem ser invocadas no telefone. Um zero indica que o recurso correspondente não está implementado e nunca pode ser invocado pelo aplicativo no telefone; um indica que o recurso pode ser invocado dependendo do estado do dispositivo e de outros fatores. Esse membro usa constantes PHONEFEATURE_.

dwSettableHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valores que podem ser definidos no aparelho usando phoneSetHookSwitch.

dwSettableSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_ valores que podem ser definidos no viva-voz usando phoneSetHookSwitch.

dwSettableHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valores que podem ser definidos no headset usando phoneSetHookSwitch.

dwMonitoredHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valores que podem ser detectados e relatados para o aparelho em uma mensagem PHONE_STATE e por phoneGetHookSwitch.

dwMonitoredSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_ valores que podem ser detectados e relatados para o viva-voz em uma mensagem PHONE_STATE e por phoneSetHookSwitch.

dwMonitoredHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ valores que podem ser detectados e relatados para o fone de ouvido em uma mensagem PHONE_STATE e por phoneSetHookSwitch.

PermanentPhoneGuid

O GUID permanentemente associado a este telefone.

Comentários

As extensões específicas do dispositivo devem usar a área de tamanho variável DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) dessa estrutura de dados.

Os membros dwDeviceClassesSize por meio de dwMonitoredHeadsetHookSwitchModes estão disponíveis apenas para aplicativos que abrem o dispositivo de telefone com uma versão de API 2.0 ou posterior.