TSPI_phoneSetDisplay-Funktion (tspi.h)
Die TSPI_phoneSetDisplay-Funktion bewirkt, dass die angegebene Zeichenfolge auf dem angegebenen geöffneten Telefongerät angezeigt wird.
Syntax
LONG TSPIAPI TSPI_phoneSetDisplay(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwRow,
DWORD dwColumn,
LPCWSTR lpsDisplay,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Das Handle für das Telefon, auf dem die Zeichenfolge angezeigt werden soll.
dwRow
Die Zeile auf der Anzeige, in der der neue Text angezeigt werden soll.
dwColumn
Die Spaltenposition auf der Anzeige, in der der neue Text angezeigt werden soll.
lpsDisplay
Ein Zeiger auf den Speicherspeicherort, an dem der Anzeigeinhalt gespeichert ist. Die Anwendung speichert die Anzeigeinformationen in dem als dwStringFormat angegebenen Format in der PHONECAPS-Struktur des Smartphones.
dwSize
Die Größe der Informationen, auf die von lpDisplay verwiesen wird, einschließlich des NULL-Abschlussators in Bytes.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder es ist eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Hinweise
Die angegebenen Anzeigeinformationen werden ab den angegebenen Positionen in das Display des Telefons geschrieben. Dieser Vorgang überschreibt zuvor angezeigte Informationen. Wenn die Menge der Informationen die Größe der Anzeige überschreitet, werden die Informationen abgeschnitten. Die Menge an Informationen, die angezeigt werden können, beträgt höchstens (dwNumRows * dwNumColumns) Elemente in der Größe. Die Elemente dwNumRows und dwNumColumns sind in der PHONECAPS-Struktur verfügbar, die von TSPI_phoneGetDevCaps zurückgegeben wird. Sie sind nullbasiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |