lineSetDevConfigA 함수(tapi.h)

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

통사론

LONG lineSetDevConfigA(
  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(디바이스 클래스)와 관련이 있으며 문서화되지 않았으며 정의되지 않았습니다. 애플리케이션은 "불투명"으로 처리해야 하며 콘텐츠를 직접 조작하지 않아야 합니다. 일반적으로 이 함수를 사용하여 구조체를 가져온 동일한 디바이스로만 보낼 수 있습니다. 그러나 특정 전화 통신 서비스 공급자는 동일한 디바이스(즉, 동일한 멀티포트 모뎀 카드의 여러 포트) 간에 구조를 교환하도록 허용할 수 있습니다. 이러한 교환성은 동일한 디바이스 클래스의 디바이스에 대해서도 어떠한 방식으로도 보장되지 않습니다.

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

메모

tapi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 lineSetDevConfig를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.