lineGetDevConfig 함수(tapi.h)

아티클
03/02/2024

lineGetDevConfig 함수는 줄(서비스 공급자) 및 디바이스 클래스와 관련된 내용인 "불투명" 데이터 구조 개체를 반환합니다. 데이터 구조 개체는 라인 디바이스와 연결된 미디어 스트림 디바이스의 현재 구성을 저장합니다.

구문

LONG lineGetDevConfig(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCSTR      lpszDeviceClass
);

매개 변수

dwDeviceID

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

lpDeviceConfig

디바이스 구성 구조가 반환되는 VARSTRING 형식의 메모리 위치에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 위치는 디바이스 구성으로 채워집니다. VARSTRING 구조체의 dwStringFormat 멤버는 STRINGFORMAT_BINARY. lineGetDevConfig를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

참고 구조의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.

lpszDeviceClass

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

반환 값

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

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

설명

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

lineGetDevConfig 함수를 사용하여 특정 라인 디바이스와 연결된 미디어 스트림 디바이스의 구성을 지정하는 TAPI에서 데이터 구조를 검색할 수 있습니다. 예를 들어 이 구조체의 내용은 줄과 연결된 "datamodem" 미디어 디바이스에 대한 데이터 속도, 문자 형식, 변조 체계 및 오류 제어 프로토콜 설정을 지정할 수 있습니다.

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

구조체 내에 포함된 데이터의 정확한 형식은 선 및 미디어 스트림 API(디바이스 클래스)와 관련이 없으며 문서화되지 않았으며 정의되지 않았습니다. 이 함수에서 반환된 구조체는 애플리케이션에서 직접 액세스하거나 조작할 수 없지만, 그대로 저장하고 나중에 lineSetDevConfig 에만 저장하여 설정을 복원할 수 있습니다. 구조체는 동일한 디바이스 클래스에서도 반드시 다른 디바이스에 전달할 수 없습니다(일부 경우에 작동할 수 있지만 보장되지는 않음).