Edit

ITMSPAddress::CreateMSPCall method (msp.h)

  • Article

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 msp.h (include Tapi3.h)

See also

ITMSPAddress

Media Service Provider Interface (MSPI)