TSPI_phoneGetData-Funktion (tspi.h)
Die TSPI_phoneGetData-Funktion lädt die Informationen von dem angegebenen Speicherort im geöffneten Telefongerät in den angegebenen Puffer hoch.
Syntax
LONG TSPIAPI TSPI_phoneGetData(
HDRVPHONE hdPhone,
DWORD dwDataID,
LPVOID lpData,
DWORD dwSize
);
Parameter
hdPhone
Der Griff für das abzufragte Telefon.
dwDataID
Gibt an, wo auf dem Telefongerät der Puffer hochgeladen werden soll.
lpData
Ein Zeiger auf den Speicherpuffer, in den die Daten hochgeladen werden sollen.
dwSize
Die Größe des Datenpuffers in Bytes. Wenn der lpData-Parameter ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlussator enthalten.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL.
Hinweise
Die TSPI_phoneGetData-Funktion lädt maximal dwSize-Bytes vom Telefongerät in lpData hoch. Wenn dwSize null ist, wird nichts kopiert. Die Größe der einzelnen Datenbereiche wird in der PHONECAPS-Struktur des Telefons aufgeführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |