Função phoneGetDisplay (tapi.h)

Artigo
08/26/2023

A função phoneGetDisplay retorna o conteúdo atual da tela do telefone especificada.

Sintaxe

LONG phoneGetDisplay(
  HPHONE      hPhone,
  LPVARSTRING lpDisplay
);

Parâmetros

hPhone

Identificador para o dispositivo de telefone aberto.

lpDisplay

Ponteiro para o local de memória em que o conteúdo de exibição deve ser armazenado, do tipo VARSTRING.

Valor retornado

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED PHONEERR_NOMEM.

Comentários

A área de memória lpDisplay deve ser pelo menos 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 phoneGetDevCaps.