ITLegacyAddressMediaControl::SetDevConfig method (tapi3if.h)

Article
02/22/2024

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.

Syntax

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

Parameters

[in] pDeviceClass

Pointer to BSTR containing TAPI device class for which configuration information is needed.

[in] dwSize

Size of configuration array.

[in] pDeviceConfig

Pointer to the array of bytes containing device configuration information obtained by a call to GetDevConfig.

Return value

This method can return one of these values.

Return code	Description
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.

TAPI 2.1 Cross-References: lineGetDevConfig, lineSetDevConfig

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)
Library	Uuid.lib
DLL	Tapi3.dll