TSPI_phoneGetButtonInfo 함수(tspi.h)
TSPI_phoneGetButtonInfo 함수는 지정된 단추에 대한 정보를 반환합니다.
구문
LONG TSPIAPI TSPI_phoneGetButtonInfo(
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO lpButtonInfo
);
매개 변수
hdPhone
쿼리할 휴대폰의 핸들입니다.
dwButtonLampID
휴대폰 장치의 단추입니다.
lpButtonInfo
서비스 공급자가 PHONEBUTTONINFO 형식의 고정 크기 구조를 작성하는 메모리에 대한 포인터입니다. 이 데이터 구조는 모드 및 함수를 설명하고 단추에 해당하는 추가 설명 텍스트를 제공합니다. TSPI_phoneGetButtonInfo 호출하기 전에 애플리케이션은 이 구조체의 dwTotalSize 멤버를 설정하여 정보를 반환하는 데 TAPI에 사용할 수 있는 메모리 양을 나타냅니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NOMEM.
설명
서비스 공급자가 단추 정보가 포함된 메모리에 액세스할 수 없는 경우 TSPI_phoneGetButtonInfo 함수는 PHONEERR_NOMEM 값을 반환합니다.
서비스 공급자는 TAPI로 채워진 dwTotalSize를 제외하고 PHONEBUTTONINFO 데이터 구조의 모든 멤버를 채웁니다. 서비스 공급자는 dwTotalSize 멤버를 덮어쓰지 않아야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |