Platform SDK: TAPI

ITMSPAddress::ReceiveTSPData

This method is called by TAPI 3.0 when the TSP sends asynchronous data to the MSP. If the TSP sends the LINE_SENDMSPDATA message with the htCall set to NULL, pMSPCall will be NULL. If the TSP does specify the htCall, pMSPCall will correspond to the call created in CreateMSPCall.

HRESULT ReceiveTSPData(
  IUnknown *pMSPCall,
  BYTE *pBuffer,
  DWORD dwSize
);

Parameters

pMSPCall: [in] Pointer to IUnknown interface of the MSP Call object.
pBuffer: [in, size_is(dwSize)] Pointer to opaque buffer from the TSP.
dwSize: [in] Size, in bytes, of pBuffer.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_POINTER	The pMSPCall or pBuffer parameter is not a valid pointer.
E_INVALIDARG	The pMSPCall parameter is NULL.
E_FAIL	The pMSPCall parameter does not point to a valid interface.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

The MSP must free memory in pBuffer.

The semantics of the data passed in the buffer are specific to each TSP/MSP pair. This method simply dispatches the received buffer to the address (pMSPCall == NULL) or the indicated call (pMSPCall != NULL).

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

ITMSPAddress::ReceiveTSPData

Parameters

Return Values

Remarks

Requirements

See Also