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 |
---|---|
|
메서드가 정상적으로 실행되었습니다. |
|
pDeviceClass, pdwSize 또는 ppDeviceConfig 매개 변수는 유효한 포인터가 아닙니다. |
|
작업을 수행하기 위한 메모리가 부족합니다. |
설명
이 메서드는 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 |