TSPI_phoneGetStatus

The TSPI_phoneGetStatus function queries the specified open phone device for its overall status.

LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,           
LPPHONESTATUS lpPhoneStatus );

Parameters

• hdPhone
  The handle to the phone to be queried.
• lpPhoneStatus
  A pointer to a variably sized data structure of type PHONESTATUS, into which the service provider writes information about the phone's status. Prior to calling TSPI_phoneGetStatus, the application sets the dwTotalSize member of this structure to indicate the amount of memory available to TAPI for returning information.

Return Values

Returns zero if the function succeeds, or an error number if an error occurs. Possible return values are as follows:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.

Remarks

The following table indicates which members of the PHONESTATUS data structure are filled in by TAPI and which members are filled in by the service provider. The service provider must not overwrite the values filled in by TAPI.

Member TAPI Service Provider

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 can use this function to determine the current state of an open phone device. The status information describes information about the phone device's hookswitch devices, ringer, volume, display, and lamps of the open phone.

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.