funzione phoneSetDisplay (tapi.h)

Articolo
03/02/2024

La funzione phoneSetDisplay causa la visualizzazione della stringa specificata nel dispositivo telefono aperto specificato.

Sintassi

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

Parametri

hPhone

Gestire il dispositivo telefono aperto. L'applicazione deve essere il proprietario del telefono.

dwRow

Posizione della riga nella visualizzazione in cui verrà visualizzato il nuovo testo.

dwColumn

Posizione della colonna nella visualizzazione in cui deve essere visualizzato il nuovo testo.

lpsDisplay

Puntatore al percorso di memoria in cui viene archiviato il contenuto visualizzato. Le informazioni di visualizzazione devono avere il formato specificato nel membro dwStringFormat della struttura PHONECAPS , che descrive le funzionalità del dispositivo del telefono.

dwSize

Dimensioni delle informazioni a cui fa riferimento lpsDisplay, in byte. Se il parametro lpsDisplay è un puntatore a una stringa, le dimensioni devono includere il terminatore Null.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di PHONE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

Le informazioni di visualizzazione specificate vengono scritte nella visualizzazione del telefono, a partire dalle posizioni specificate. Questa operazione sovrascrive le informazioni visualizzate in precedenza. Se la quantità di informazioni supera le dimensioni della visualizzazione, le informazioni vengono troncate. La quantità di informazioni che possono essere visualizzate è al massimo (dwNumRows * dwNumColumns) elementi in dimensione. dwNumRows e dwNumColumns sono disponibili nella struttura PHONECAPS , restituita da phoneGetDevCaps; sono in base zero.