TSPI_phoneGetStatus 함수(tspi.h)

  • 아티클

TSPI_phoneGetStatus 함수는 전체 상태 대해 지정된 개방형 휴대폰 디바이스를 쿼리합니다.

구문

LONG TSPIAPI TSPI_phoneGetStatus(
  HDRVPHONE     hdPhone,
  LPPHONESTATUS lpPhoneStatus
);

매개 변수

hdPhone

쿼리할 휴대폰의 핸들입니다.

lpPhoneStatus

서비스 공급자가 휴대폰의 상태 대한 정보를 쓰는 PHONESTATUS 형식의 고정 크기 데이터 구조에 대한 포인터입니다. TSPI_phoneGetStatus 호출하기 전에 애플리케이션은 이 구조체의 dwTotalSize 멤버를 설정하여 정보를 반환하는 데 TAPI에 사용할 수 있는 메모리 양을 나타냅니다.

반환 값

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.

설명

다음 표에서는 TAPI로 채워진 PHONESTATUS 데이터 구조의 멤버와 서비스 공급자가 채우는 멤버를 나타냅니다. 서비스 공급자는 TAPI로 채워진 값을 덮어써서는 안됩니다.

멤버 Tapi 서비스 공급자
dwTotalSize; X  
dwNeededSize;   X
dwUsedSize;   X
dwStatusFlags;   X
dwNumOwners; X  
dwNumMonitors; X  
dwRingMode;   X
dwRingVolume;   X
dwHandsetHookSwitchMode;   X
dwHandsetVolume;   X
dwHandsetGain;   X
dwSpeakerHookSwitchMode;   X
dwSpeakerVolume;   X
dwSpeakerGain;   X
dwHeadsetHookSwitchMode;   X
dwHeadsetVolume;   X
dwHeadsetGain;   X
dwDisplaySize;   X
dwDisplayOffset;   X
dwLampModesSize;   X
dwLampModesOffset;   X
dwOwnerNameSize; X  
dwOwnerNameOffset; X  
dwDevSpecificSize;   X
dwDevSpecificOffset;   X
 

TAPI는 이 함수를 사용하여 개방형 휴대폰 디바이스의 현재 상태를 확인할 수 있습니다. 상태 정보는 휴대폰 장치의 후크위치 디바이스, 벨소리, 볼륨, 디스플레이 및 오픈 폰의 램프에 대한 정보를 설명합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tspi.h

추가 정보

PHONESTATUS

PHONE_STATE