Função phoneSetDisplay (tapi.h)

Artigo
03/02/2024

A função phoneSetDisplay faz com que a cadeia de caracteres especificada seja exibida no dispositivo de telefone aberto especificado.

Sintaxe

LONG phoneSetDisplay(
  HPHONE hPhone,
  DWORD  dwRow,
  DWORD  dwColumn,
  LPCSTR lpsDisplay,
  DWORD  dwSize
);

Parâmetros

hPhone

Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do telefone.

dwRow

Posição da linha na exibição em que o novo texto deve ser exibido.

dwColumn

Posição da coluna na exibição em que o novo texto deve ser exibido.

lpsDisplay

Ponteiro para o local de memória em que o conteúdo de exibição está armazenado. As informações de exibição devem ter o formato especificado no membro dwStringFormat da estrutura PHONECAPS , que descreve os recursos do dispositivo do telefone.

dwSize

Tamanho das informações apontadas por lpsDisplay, em bytes. Se o parâmetro lpsDisplay for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo.

Retornar valor

Retornará um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de PHONE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_INVALPARAM PHONEERR_RESOURCEUNAVAIL.

Comentários

As informações de exibição especificadas são gravadas na tela do telefone, começando nas posições especificadas. Essa operação substitui as informações exibidas anteriormente. Se a quantidade de informações exceder o tamanho da exibição, as informações serão truncadas. A quantidade de informações que podem ser exibidas é, no máximo, elementos (dwNumRows * dwNumColumns) em tamanho. dwNumRows e dwNumColumns estão disponíveis na estrutura PHONECAPS , que é retornada por phoneGetDevCaps; eles são baseados em zero.