TSPI_lineCreateMSPInstance function (tspi.h)
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 |