TSPI_lineCreateMSPInstance function (tspi.h)

Article
02/22/2024

The TSPI_lineCreateMSPInstance function directs the TAPI 3 DLL to create a media service provider (MSP) instance for a specific line device. This function returns a TSP handle for the MSP call. This function requires TAPI 3.0 version negotiation.

Syntax

LONG TSPIAPI TSPI_lineCreateMSPInstance(
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HTAPIMSPLINE  htMSPLine,
  LPHDRVMSPLINE lphdMSPLine
);

Parameters

hdLine

The service provider's handle to the line.

dwAddressID

An address on the specified open line device. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.

htMSPLine

The TAPI handle for the MSP call.

lphdMSPLine

Pointer to the TSP handle for the MSP call.

Return value

LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, NOERROR

Remarks

The service provider should save the htMSPLine handle field, to be used when sending LINE_SENDMSPDATA messages to TAPISRV.

An MSP instance is associated with a particular application. If multiple applications are running, each TSP line may have multiple MSP instances.

Requirements

Requirement	Value
Target Platform	Windows
Header	tspi.h