phoneSetDisplay-Funktion (tapi.h)

Artikel
08/26/2023

Die phoneSetDisplay-Funktion bewirkt, dass die angegebene Zeichenfolge auf dem angegebenen geöffneten Telefongerät angezeigt wird.

Syntax

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

Parameter

hPhone

Handle zum geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefons sein.

dwRow

Zeilenposition auf der Anzeige, auf der der neue Text angezeigt werden soll.

dwColumn

Spaltenposition auf der Anzeige, auf der der neue Text angezeigt werden soll.

lpsDisplay

Zeiger auf den Speicherort, an dem der Anzeigeinhalt gespeichert ist. Die Anzeigeinformationen müssen das Format aufweisen, das im dwStringFormat-Element der PHONECAPS-Struktur angegeben ist, das die Gerätefunktionen des Telefons beschreibt.

dwSize

Größe der Informationen, auf die von lpsDisplay in Bytes verwiesen wird. Wenn der lpsDisplay-Parameter ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlusszeichen enthalten.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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

Hinweise

Die angegebenen Anzeigeinformationen werden auf die Anzeige des Telefons geschrieben, beginnend an den angegebenen Positionen. Dieser Vorgang überschreibt zuvor angezeigte Informationen. Wenn die Informationsmenge die Größe der Anzeige überschreitet, werden die Informationen abgeschnitten. Die Menge an Informationen, die angezeigt werden können, ist höchstens (dwNumRows * dwNumColumns)-Elemente groß. dwNumRows und dwNumColumns sind in der PHONECAPS-Struktur verfügbar, die von phoneGetDevCaps zurückgegeben wird. sie sind nullbasiert.