ITMSPAddress::CreateMSPCall method (tapi3.h)

The CreateMSPCall method creates an MSP Call object. TAPI aggregates this onto the main Call object and exposes the ITStreamControl interface.

Syntax

HRESULT CreateMSPCall(
  [in]  MSP_HANDLE hCall,
  [in]  DWORD      dwReserved,
  [in]  DWORD      dwMediaType,
  [in]  IUnknown   *pOuterUnknown,
  [out] IUnknown   **ppStreamControl
);

Parameters

[in] hCall

Handle for this MSP.

[in] dwReserved

Reserved value – will be 0.

[in] dwMediaType

Indicates media types required for the call.

[in] pOuterUnknown

The pointer to the IUnknown interface on the TAPI 3 call object. Since the MSP Call object is aggregated in the TAPI 3 call object, it needs to know the outer IUnknown.

[out] ppStreamControl

Pointer to IUnknown interface pointer of ITStreamControl interface for newly created call.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_FAIL	The MSP failed to initialize.
E_POINTER	pMSPCallback is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
TAPI_E_INVALIDMEDIATYPE	dwMediaType is not a valid media type.

Requirements

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

See also

ITMSPAddress

Media Service Provider Interface (MSPI)