Estrutura PHONESTATUS (tapi.h)

Artigo
08/26/2023

A estrutura PHONESTATUS descreve o status atual de um dispositivo de telefone. As funções phoneGetStatus e TSPI_phoneGetStatus retornam essa estrutura.

Sintaxe

typedef struct phonestatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwStatusFlags;
  DWORD dwNumOwners;
  DWORD dwNumMonitors;
  DWORD dwRingMode;
  DWORD dwRingVolume;
  DWORD dwHandsetHookSwitchMode;
  DWORD dwHandsetVolume;
  DWORD dwHandsetGain;
  DWORD dwSpeakerHookSwitchMode;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerGain;
  DWORD dwHeadsetHookSwitchMode;
  DWORD dwHeadsetVolume;
  DWORD dwHeadsetGain;
  DWORD dwDisplaySize;
  DWORD dwDisplayOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwOwnerNameSize;
  DWORD dwOwnerNameOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;

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.

dwStatusFlags

Sinalizadores de status para este dispositivo de telefone. Esse membro usa uma das constantes PHONESTATUSFLAGS_.

dwNumOwners

Número de módulos de aplicativo com privilégio de proprietário para o telefone.

dwNumMonitors

Número de módulos de aplicativo com privilégio de monitor para o telefone.

dwRingMode

Modo de toque atual de um dispositivo de telefone.

dwRingVolume

Volume de toque atual de um dispositivo de telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (volume máximo).

dwHandsetHookSwitchMode

Modo hookswitch atual do aparelho do telefone. Esse membro usa uma das constantes PHONEHOOKSWITCHMODE_.

dwHandsetVolume

Volume de alto-falante atual do dispositivo do telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (volume máximo).

dwHandsetGain

Ganho de microfone atual do dispositivo do telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (ganho máximo).

dwSpeakerHookSwitchMode

Modo hookswitch atual do viva-voz do telefone. Esse membro usa uma das constantes PHONEHOOKSWITCHMODE_.

dwSpeakerVolume

Volume de alto-falante atual do dispositivo de alto-falante do telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (volume máximo).

dwSpeakerGain

Ganho de microfone atual do dispositivo de alto-falante do telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (ganho máximo).

dwHeadsetHookSwitchMode

Modo hookswitch atual do fone de ouvido do telefone. Esse membro usa uma das constantes PHONEHOOKSWITCHMODE_.

dwHeadsetVolume

Volume de alto-falante atual do dispositivo de fone de ouvido do telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (volume máximo).

dwHeadsetGain

Ganho de microfone atual do dispositivo de fone de ouvido do telefone. Esse é um valor entre 0x00000000 (silêncio) e 0x0000FFFF (ganho máximo).

dwDisplaySize

Tamanho das informações de exibição, em bytes.

dwDisplayOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém as informações de exibição atuais do telefone. O tamanho do campo é especificado por dwDisplaySize.

dwLampModesSize

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

dwLampModesOffset

Deslocamento do início dessa estrutura para o campo de tamanho variável que contém os modos de lâmpada atuais do telefone. O tamanho do campo é especificado por dwLampModesSize.

dwOwnerNameSize

Tamanho do nome do proprietário atual, incluindo o terminador nulo , em bytes.

dwOwnerNameOffset

Deslocamento do início da estrutura para o campo de tamanho variável que contém o nome do aplicativo que é o proprietário atual do dispositivo de telefone. O nome é o nome do aplicativo fornecido pelo aplicativo quando invocado com phoneInitialize ou phoneInitializeEx. Se nenhum nome de aplicativo tiver sido fornecido, o nome do arquivo do aplicativo será usado. O tamanho do campo é especificado por dwOwnerNameSize. Se o telefone atualmente não tiver proprietário, dwOwnerNameSize será zero.

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.

dwPhoneFeatures

Sinalizadores que indicam quais funções da API de Telefonia podem ser invocadas no telefone, considerando a disponibilidade do recurso nas funcionalidades do dispositivo, o estado atual do dispositivo e a propriedade do dispositivo do aplicativo invocador. Um zero indica que o recurso correspondente não pode ser invocado pelo aplicativo no telefone em seu estado atual; um indica que o recurso pode ser invocado. Esse membro usa uma ou mais das constantes PHONEFEATURE_.

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.

O membro dwPhoneFeatures está disponível apenas para aplicativos que abrem o dispositivo de telefone com uma versão de API 2.0 ou posterior.