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 |