função TSPI_phoneSetDisplay (tspi.h)
A função TSPI_phoneSetDisplay faz com que a cadeia de caracteres especificada seja exibida no dispositivo de telefone aberto especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneSetDisplay(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwRow,
DWORD dwColumn,
LPCWSTR lpsDisplay,
DWORD dwSize
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdPhone
O identificador para o telefone no qual a cadeia de caracteres deve ser exibida.
dwRow
A linha na exibição em que o novo texto deve ser exibido.
dwColumn
A posição da coluna na exibição em que o novo texto deve ser exibido.
lpsDisplay
Um ponteiro para o local de memória em que o conteúdo de exibição está armazenado. O aplicativo armazena as informações de exibição no formato especificado como dwStringFormat na estrutura PHONECAPS do telefone.
dwSize
O tamanho em bytes, incluindo o terminador nulo , das informações apontadas por lpDisplay.
Retornar valor
Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou se for um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
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. Os membros dwNumRows e dwNumColumns estão disponíveis na estrutura PHONECAPS retornada por TSPI_phoneGetDevCaps; eles são baseados em zero.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |