Platform SDK: TAPI

TSPI_lineCreateMSPInstance

The TSPI_lineCreateMSPInstance function directs the TAPI 3.0 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.

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 Values

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.exe.

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tspi.h.

See Also

About The Media Service Provider (MSP), TSPI_lineMSPIdentify, TSPI_lineReceiveMSPData, TSPI_lineCloseMSPInstance, LINEDEVCAPS