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 멤버를 덮어쓰지 않아야 합니다.

요구 사항

추가 정보

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneSetButtonInfo