Edit

Share via

ITLegacyAddressMediaControl::GetDevConfig method (tapi3if.h)

  • Article

The GetDevConfig method returns an opaque data structure. The exact contents are specific to the service provider and device class. The data structure specifies the configuration of a device associated with a particular line device. For example, the contents of this structure could specify data rate, character format, modulation schemes, and error control protocol settings for a datamodem device associated with the line.

Syntax

HRESULT GetDevConfig(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceConfig
);

Parameters

[in] pDeviceClass

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

[out] pdwSize

Pointer to size of configuration array.

[out] ppDeviceConfig

Pointer to array of bytes containing device configuration information.

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_OUTOFMEMORY
 Insufficient memory exists to perform the operation.

Remarks

This method is a COM wrapper for the LineGetDevConfig 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.

The application must call the CoTaskMemFree function to free the memory allocated for the ppDeviceConfig parameter.

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

See also

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig