Platform SDK: TAPI

ITMSPAddress::CreateMSPCall

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

HRESULT CreateMSPCall(
  MSP_HANDLE hCall,
  DWORD dwReserved,
  DWORD dwMediaType,
  IUnknown *pOuterUnknown,
  IUnknown **ppStreamControl
);

Parameters

hCall
[in] Handle for this MSP.
dwReserved
[in] Reserved value – will be 0.
dwMediaType
[in] Indicates media types required for the call.
pOuterUnknown
[in] The pointer to the IUnknown interface on the TAPI 3.0 call object. Since the MSP Call object is aggregated in the TAPI 3.0 call object, it needs to know the outer IUnknown.
ppStreamControl
[out] Pointer to IUnknown interface pointer of ITStreamControl interface for newly created call.

Return 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

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

Media Service Provider Interface (MSPI), ITMSPAddress