phoneGetID 함수(tapi.h)

아티클
03/02/2024

phoneGetID 함수는 지정된 휴대폰 디바이스와 연결된 지정된 디바이스 클래스에 대한 디바이스 식별자를 반환합니다.

구문

LONG phoneGetID(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

매개 변수

hPhone

열려 있는 휴대폰 디바이스에 대한 핸들입니다.

lpDeviceID

디바이스 식별자가 반환되는 VARSTRING 형식의 데이터 구조에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 위치는 디바이스 식별자로 채워집니다. 반환된 정보의 형식은 디바이스 이름 지정을 위해 API(디바이스 클래스)에서 사용하는 메서드에 따라 달라집니다.

lpszDeviceClass

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

반환 값

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

설명

phoneGetID 함수를 사용하여 휴대폰 핸들이 지정된 휴대폰 디바이스 식별자를 검색할 수 있습니다. 또한 열린 휴대폰 디바이스와 연결된 미디어 디바이스의 디바이스 식별자(COM, 웨이브, MIDI, 전화, 회선 또는 NDIS와 같은 디바이스 클래스의 경우)를 가져오는 데 사용할 수도 있습니다. 이러한 디바이스 클래스의 이름은 대/소문자를 구분하지 않습니다. 그런 다음 이 식별자를 적절한 미디어 API와 함께 사용하여 해당 디바이스를 선택할 수 있습니다.

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

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