lineSetDevConfig 함수(tapi.h)

아티클
03/02/2024

lineSetDevConfig 함수를 사용하면 애플리케이션이 라인 디바이스의 미디어 스트림 디바이스 구성을 lineGetDevConfig를 사용하여 이전에 가져온 설정으로 복원할 수 있습니다. 예를 들어 이 구조체의 내용은 줄과 연결된 "datamodem" 미디어 디바이스에 대한 데이터 속도, 문자 형식, 변조 체계 및 오류 제어 프로토콜 설정을 지정할 수 있습니다.

구문

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

매개 변수

dwDeviceID

구성할 라인 디바이스의 식별자입니다.

lpDeviceConfig

VARSTRING 구조체의 변수 부분에서 lineGetDevConfig에 의해 반환된 불투명 구성 데이터 구조체에 대한 포인터입니다.

dwSize

lpDeviceConfig가 가리키는 구조체의 바이트 수입니다. 이 값은 lineGetDevConfig에서 반환된 VARSTRING 구조체의 dwStringSize 멤버에 반환됩니다.

lpszDeviceClass

구성을 설정할 디바이스의 디바이스 클래스를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 유효한 디바이스 클래스 문자열은 lineGetID 함수에 지정된 문자열과 동일합니다.

반환 값

함수가 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.

설명

호출 상태는 디바이스별로 다릅니다.

일반적으로 애플리케이션은 lineGetID 를 호출하여 선과 연결된 미디어 스트림 디바이스를 식별한 다음 lineConfigDialog 를 호출하여 사용자가 디바이스 구성을 설정할 수 있도록 합니다. 그런 다음 lineGetDevConfig 를 호출하고 특정 통화 대상과 연결된 전화 번호부 또는 기타 데이터베이스에 구성 정보를 저장할 수 있습니다. 사용자가 동일한 대상을 다시 호출하려는 경우 이 lineSetDevConfig 함수를 사용하여 사용자가 선택한 구성 설정을 복원할 수 있습니다. 사용자가 설정을 보고 업데이트할 수 있도록 lineSetDevConfig, lineConfigDialog 및 lineGetDevConfig 함수를 순서대로 사용할 수 있습니다.

구조체 내에 포함된 데이터의 정확한 형식은 선 및 미디어 스트림 API(디바이스 클래스)와 관련이 없으며 문서화되지 않았으며 정의되지 않았습니다. 애플리케이션은 이를 "불투명"으로 처리하고 콘텐츠를 직접 조작하지 않아야 합니다. 일반적으로 이 함수를 사용하여 구조체를 가져온 동일한 디바이스로만 보낼 수 있습니다. 그러나 특정 전화 통신 서비스 공급자는 동일한 디바이스(즉, 동일한 멀티포트 모뎀 카드 여러 포트) 간에 구조를 교환하도록 허용할 수 있습니다. 동일한 디바이스 클래스의 디바이스에서도 이러한 교환성이 보장되지 않습니다.

일부 서비스 공급자는 호출이 활성 상태인 동안 구성을 설정하도록 허용할 수 있으며 다른 서비스 공급자는 설정하지 않을 수 있습니다.