TSPI_phoneSetData-Funktion (tspi.h)
Die funktion TSPI_phoneSetData lädt die Informationen im angegebenen Puffer am ausgewählten Datenbezeichner auf das geöffnete Telefongerät herunter.
Syntax
LONG TSPIAPI TSPI_phoneSetData(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwDataID,
LPVOID const lpData,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Das Handle für das Telefon, in das Daten heruntergeladen werden sollen.
dwDataID
Gibt an, wo auf dem Telefongerät der Puffer heruntergeladen werden soll.
lpData
Ein Zeiger auf den Speicherort, von dem die Daten heruntergeladen werden sollen.
dwSize
Die Größe des Puffers in Byte. Wenn der lpData-Parameter ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlusszeichen enthalten.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder es ist eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDATAID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Hinweise
Die Funktion lädt maximal dwSize Bytes von lpData auf das Telefongerät herunter. Das Format der Daten, ihre Bedeutung für das Telefongerät und die Bedeutung des Datenbezeichners sind dienstanbieterspezifisch. Die Daten im Puffer oder die Auswahl eines Datenbezeichners können als Befehle für das Telefongerät fungieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |