TSPI_phoneSetData

The TSPI_phoneSetData function downloads the information in the specified buffer to the opened phone device at the selected data identifier.

LONG TSPIAPI TSPI_phoneSetData(
  DRV_REQUESTID dwRequestID,  
  HDRVPHONE hdPhone,          
  DWORD dwDataID,             
  LPVOID const lpData,        
  DWORD dwSize                
);

Parameters

dwRequestID

The identifier of the asynchronous request.

hdPhone

The handle to the phone into which data is to be downloaded.

dwDataID

Specifies where in the phone device the buffer is to be downloaded.

lpData

A pointer to the memory location where the data is to be downloaded from.

dwSize

The size of the buffer in bytes.

Return Values

Returns dwRequestID, or an error number if an error occurs. The lResult actual parameter of the corresponding ASYNC_COMPLETION is zero if the function succeeds or it is an error number if an error occurs. Possible return values are as follows:

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

Remarks

The function downloads a maximum of dwSize bytes from lpData to the phone device. The format of the data, its meaning to the phone device, and the meaning of the data identifier are service-provider specific. The data in the buffer or the selection of a data identifier can act as commands to the phone device.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 1.3 or later.
  Header: Declared in Tspi.h.

See Also

ASYNC_COMPLETION, PHONECAPS, TSPI_phoneGetData, TSPI_phoneGetDevCaps