função TSPI_phoneGetButtonInfo (tspi.h)
A função TSPI_phoneGetButtonInfo retorna informações sobre um botão especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneGetButtonInfo(
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO lpButtonInfo
);
Parâmetros
hdPhone
O identificador para o telefone a ser consultado.
dwButtonLampID
Um botão no dispositivo do telefone.
lpButtonInfo
Um ponteiro para a memória na qual o provedor de serviços grava uma estrutura de tamanho variavelmente do tipo PHONEBUTTONINFO. Essa estrutura de dados descreve o modo e a função e fornece texto descritivo adicional correspondente ao botão. Antes de chamar TSPI_phoneGetButtonInfo, o aplicativo define o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NOMEM.
Comentários
A função TSPI_phoneGetButtonInfo retornará o valor PHONEERR_NOMEM se o provedor de serviços não puder acessar a memória que contém as informações do botão.
O provedor de serviços preenche todos os membros da estrutura de dados PHONEBUTTONINFO , exceto dwTotalSize, que é preenchido pelo TAPI. O provedor de serviços não deve substituir o membro dwTotalSize .
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |