TSPI_phoneGetID 함수(tspi.h)
TSPI_phoneGetID 함수는 지정된 휴대폰 디바이스와 연결된 지정된 디바이스 클래스에 대한 디바이스 식별자를 반환합니다.
구문
LONG TSPIAPI TSPI_phoneGetID(
HDRVPHONE hdPhone,
LPVARSTRING lpDeviceID,
LPCWSTR lpszDeviceClass,
HANDLE hTargetProcess
);
매개 변수
hdPhone
쿼리할 휴대폰의 핸들입니다.
lpDeviceID
디바이스 식별자가 반환되는 VARSTRING 형식의 데이터 구조에 대한 포인터입니다. 반환된 정보의 형식은 디바이스 이름을 지정하기 위해 API(디바이스 클래스)에서 사용하는 방법에 따라 달라집니다. TSPI_phoneGetID 호출하기 전에 애플리케이션은 이 구조체의 dwTotalSize 멤버를 설정하여 정보를 반환하는 데 TAPI에 사용할 수 있는 메모리 양을 나타냅니다.
lpszDeviceClass
식별자가 요청된 디바이스의 디바이스 클래스를 지정하는 null로 종료된 유니코드 문자열에 대한 포인터입니다.
hTargetProcess
TSPI_phoneGetID 함수가 호출되는 애플리케이션의 프로세스 핸들입니다. VARSTRING 구조에서 반환되는 정보에 애플리케이션에서 사용할 핸들이 포함된 경우 서비스 공급자는 프로세스에 대한 핸들을 만들거나 복제합니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
설명
이 작업은 전화 핸들이 지정된 휴대폰 디바이스 식별자를 검색하는 데 사용할 수 있습니다. 또한 열린 휴대폰 디바이스와 연결된 미디어 디바이스의 디바이스 식별자(COM, 웨이브, MIDI, 휴대폰, 라인 및 mciwave와 같은 디바이스 클래스의 경우)를 가져오는 데 사용할 수도 있습니다. 그런 다음 이 식별자를 적절한 미디어 API(예: mci, midi 및 wav)와 함께 사용하여 해당 디바이스를 선택할 수 있습니다. 일반적인 디바이스 클래스 이름에 대한 자세한 내용은 TSPI 디바이스 클래스를 참조하세요.
서비스 공급자는 TAPI로 채워진 dwTotalSize를 제외하고 VARSTRING 데이터 구조의 모든 멤버를 채웁니다. 서비스 공급자는 dwTotalSize 멤버를 덮어쓰지 않아야 합니다.
TAPI는 서비스 공급자에 대해 이를 처리하므로 서비스 공급자는 tapi/line 및 tapi/phone 디바이스 클래스를 처리하는 데 관심이 없습니다. 따라서 이러한 디바이스 클래스를 처리하기 위한 코드는 선택 사항입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |