Platform SDK: TAPI

ITLegacyAddressMediaControl::SetDevConfig

The SetDevConfig function allows the application to restore the configuration of a media stream device on a line device to a setup previously obtained using GetDevConfig.

HRESULT SetDevConfig(
  BSTR pDeviceClass,
  DWORD dwSize,
  BYTE *pDeviceConfig
);

Parameters

pDeviceClass: [in] Pointer to BSTR containing TAPI device class for which configuration information is needed.
dwSize: [in] Size of configuration array.
pDeviceConfig: [in, size_is(dwSize)] Pointer to the array of bytes containing device configuration information obtained by a call to GetDevConfig.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_POINTER	The pDeviceClass, pdwSize, or ppDeviceConfig parameter is not a valid pointer.
E_INVALIDARG	The pdwSize parameter is zero.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

This method is a COM wrapper for the LineSetDevConfig TAPI 2.1 function.

The GetID must be performed prior to calling this method.

The application must use SysAllocString to allocate memory for the pDeviceClass parameter and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

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

ITLegacyAddressMediaControl::SetDevConfig

Parameters

Return Values

Remarks

Requirements

See Also