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)