função TSPI_phoneGetDisplay (tspi.h)
A função TSPI_phoneGetDisplay retorna o conteúdo atual da exibição de telefone especificada.
Sintaxe
LONG TSPIAPI TSPI_phoneGetDisplay(
HDRVPHONE hdPhone,
LPVARSTRING lpDisplay
);
Parâmetros
hdPhone
O identificador para o telefone a ser consultado.
lpDisplay
Um ponteiro para o local de memória em que o conteúdo de exibição deve ser armazenado pelo provedor, do tipo VARSTRING. Antes de chamar TSPI_phoneGetDisplay, o aplicativo define o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.
Valor retornado
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentários
A área de memória lpDisplay deve ser pelo menos os elementos dwDisplayNumRows * dwDisplayNumColumns em tamanho para receber todas as informações de exibição. Os membros dwDisplayNumRows e dwDisplayNumColumns estão disponíveis na estrutura PHONECAPS retornada por TSPI_phoneGetDevCaps.
O provedor de serviços preenche todos os membros da estrutura de dados VARSTRING , exceto dwTotalSize, que é preenchido pelo TAPI. O provedor de serviços não deve substituir o membro dwTotalSize .
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |