phoneGetData-Funktion (tapi.h)
Die phoneGetData-Funktion lädt die Informationen vom angegebenen Speicherort auf dem geöffneten Telefongerät in den angegebenen Puffer hoch.
Syntax
LONG phoneGetData(
HPHONE hPhone,
DWORD dwDataID,
LPVOID lpData,
DWORD dwSize
);
Parameter
hPhone
Handle zum geöffneten Telefongerät.
dwDataID
Wo auf dem Telefongerät der Puffer hochgeladen werden soll.
lpData
Zeiger auf den Speicherpuffer, in den die Daten hochgeladen werden sollen.
dwSize
Größe des Datenpuffers in Bytes.
Rückgabewert
Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Die Funktion lädt maximal dwSize-Bytes vom Telefongerät in den Speicherbereich hoch, auf den lpData verweist. Wenn dwSize null ist, wird nichts kopiert. Die Größe der einzelnen Datenbereiche wird in den Gerätefunktionen des Telefons aufgeführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |