Estrutura PHONESTATUS (tapi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | tapi.h |