funzione phoneGetData (tapi.h)

La funzione phoneGetData carica le informazioni dalla posizione specificata nel dispositivo telefono aperto nel buffer specificato.

Sintassi

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

Parametri

hPhone

Gestire il dispositivo telefono aperto.

dwDataID

Dove nel dispositivo telefonico il buffer deve essere caricato.

lpData

Puntatore al buffer di memoria in cui devono essere caricati i dati.

dwSize

Dimensioni del buffer dei dati, in byte.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Commenti

La funzione carica un massimo di byte dwSize dal dispositivo telefonico nell'area di memoria a cui punta lpData. Se dwSize è zero, non viene copiato nulla. Le dimensioni di ogni area dati sono elencate nelle funzionalità del dispositivo del telefono.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tapi.h
Libreria	Tapi32.lib
DLL	Tapi32.dll

Vedi anche

Funzioni di servizio telefonico supplementari

Panoramica di riferimento su TAPI 2.2