ITLegacyAddressMediaControl::GetDevConfig 메서드(tapi3if.h)

GetDevConfig 메서드는 불투명 데이터 구조를 반환합니다. 정확한 콘텐츠는 서비스 공급자 및 디바이스 클래스에 따라 다릅니다. 데이터 구조는 특정 줄 디바이스와 연결된 디바이스의 구성을 지정합니다. 예를 들어 이 구조체의 내용은 줄과 연결된 datamodem 디바이스에 대한 데이터 속도, 문자 형식, 변조 체계 및 오류 제어 프로토콜 설정을 지정할 수 있습니다.

구문

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

매개 변수

[in] pDeviceClass

구성 정보가 필요한 TAPI 디바이스 클래스를 포함하는 BSTR에 대한 포인터입니다.

[out] pdwSize

구성 배열의 크기에 대한 포인터입니다.

[out] ppDeviceConfig

디바이스 구성 정보를 포함하는 바이트 배열에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
메서드가 정상적으로 실행되었습니다.
E_POINTER
pDeviceClass, pdwSize 또는 ppDeviceConfig 매개 변수는 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
작업을 수행하기 위한 메모리가 부족합니다.

설명

이 메서드는 LineGetDevConfig TAPI 2.1 함수에 대한 COM 래퍼입니다.

GetID는 이 메서드를 호출하기 전에 수행해야 합니다.

애플리케이션은 SysAllocString을 사용하여 pDeviceClass 매개 변수에 대한 메모리를 할당하고 SysFreeString을 사용하여 변수가 더 이상 필요하지 않을 때 메모리를 해제해야 합니다.

애플리케이션은 CoTaskMemFree 함수를 호출하여 ppDeviceConfig 매개 변수에 할당된 메모리를 해제해야 합니다.

TAPI 2.1 상호 참조: lineGetDevConfig, lineSetDevConfig

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 tapi3if.h(Tapi3.h 포함)
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig