ITLegacyAddressMediaControl::GetDevConfig

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.

HRESULT GetDevConfig(
  BSTR pDeviceClass,
  DWORD *pdwSize,
  BYTE **ppDeviceConfig
);

Parameters

pDeviceClass

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

pdwSize

[out] Pointer to size of configuration array.

ppDeviceConfig

[out, size_is(,*pdwSize)] Pointer to array of bytes containing device configuration information.

Return Values

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.

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

ITLegacyAddressMediaControl, SetDevConfig, ITLegacyCallMediaControl

TAPI 2.1 Cross-reference: LineGetDevConfig, LineSetDevConfig