lineGetID 함수(tapi.h)

아티클
03/05/2024

lineGetID 함수는 선택한 줄, 주소 또는 호출과 연결된 지정된 디바이스 클래스에 대한 디바이스 식별자를 반환합니다.

구문

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

매개 변수

hLine

열린 줄 디바이스에 대한 핸들입니다.

dwAddressID

지정된 열린 줄 디바이스의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

hCall

호출에 대한 핸들입니다.

dwSelect

요청된 디바이스 식별자가 줄, 주소 또는 단일 호출과 연결되어 있는지 여부를 지정합니다. 이 매개 변수는 LINECALLSELECT_ 상수 중 하나만 사용합니다.

lpDeviceID

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

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

lpszDeviceClass

식별자가 요청된 디바이스의 디바이스 클래스를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 유효한 디바이스 클래스 문자열은 SYSTEM.INI 섹션에서 디바이스 클래스를 식별하는 데 사용되는 문자열입니다.

반환 값

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

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

설명

lineGetID 함수는 줄 핸들이 제공될 때 줄 디바이스 식별자를 검색하는 데 사용할 수 있습니다. 이는 LINEMAPPER를 디바이스 식별자로 사용하여 lineOpen 을 연 후 열린 줄의 실제 줄 디바이스 식별자를 확인하는 데 유용합니다. 이 함수는 통화, 주소 또는 회선과 연결된 전화 장치 또는 미디어 디바이스(COM, 웨이브, MIDI, 전화, 회선 또는 NDIS와 같은 디바이스 클래스의 경우)의 디바이스 식별자를 가져오는 데 사용할 수도 있습니다. 그런 다음, 이 식별자를 적절한 API(예: 전화, MIDI, 웨이브)와 함께 사용하여 지정된 호출과 연결된 해당 미디어 디바이스를 선택할 수 있습니다.

디바이스 클래스 이름은 TAPI 디바이스 클래스를 참조하세요.

디바이스별 미디어 모드를 정의하는 공급업체도 미디어 모드의 디바이스를 관리하기 위해 해당 디바이스별(독점) API를 정의해야 합니다. 다른 공급업체에서 독립적으로 할당한 디바이스 클래스 이름에서 충돌을 방지하려면 공급업체가 공급업체와 그 다음에 미디어 유형을 고유하게 식별하는 이름을 선택해야 합니다. 예: "intel/video".