ITMSPAddress::ReceiveTSPData method (msp.h)

Article
02/22/2024

The ReceiveTSPData method is called by TAPI 3 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.

Syntax

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

Parameters

[in] pMSPCall

Pointer to IUnknown interface of the MSP Call object.

pBuffer

[in, size_is(dwSize)] Pointer to opaque buffer from the TSP.

[in] dwSize

Size, in bytes, of pBuffer.

Return value

This method can return one of these 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

Requirement	Value
Target Platform	Windows
Header	msp.h (include Tapi3.h)