![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
MBasicGsmPhoneSignalandBer |
Mixin: interface for accessing signal strength and bit error rate information. |
etelbgsm.h
gsmbas.lib
This class defines the protocol for accessing phone signal strength and bit error rate information.
protected: MBasicGsmPhoneSignalandBer()
The default C++ constructor is protected, which prevents objects of this class from being constructed. This class is intended only as an abstract base for other classes.
virtual TInt GetSignalCaps(TSignalAndBerCapsFlags& aCaps) const=0;
This function retrieves the signal and bit error rate capabilities of the phone.
TSignalAndBerCapsFlags& aCaps |
On return, contains the signal and bit error rate capabilities. |
TInt |
An error code: see System error codes. |
virtual void NotifySignalCaps(TRequestStatus& aStatus, TSignalAndBerCapsFlags& aCaps)=0;
This function requests notification of a change in the signal and bit error rate capabilities of the phone.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TSignalAndBerCapsFlags& aCaps |
On request completion, contains the signal and bit error rate capabilities. |
virtual void NotifySignalCapsCancel() const=0;
This function cancels an outstanding signal strength and bit error rate capabilities change notification request, placed using the NotifySignalCaps() function.
virtual TInt GetSignalStrength(TInt32& aSignalStrength) const=0;
This function returns the current phone signal strength.
TInt32& aSignalStrength |
On return, contains the current phone signal strength (in dBm). |
TInt |
An error code: see System error codes. |
virtual void GetSignalStrength(TRequestStatus& aStatus, TInt32& aSignalStrength)=0;
This function asynchronously returns the current phone signal strength.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TInt32& aSignalStrength |
On request completion, contains the current phone signal strength (in dBm). |
virtual void GetSignalStrengthCancel() const=0;
This function cancels an outstanding signal strength retrieval request, placed using the asynchronous variant of the GetSignalStrength() function.
virtual void SignalStrengthNotification(TRequestStatus& aStatus,TInt32& aSignalStrength)=0;
This function notifies the client of a change of signal strength.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TInt32& aSignalStrength |
On request completion, contains the new signal strength value (in dBm). |
virtual void SignalStrengthNotificationCancel() const=0;
This function cancels an outstanding signal strength notification request, placed using the SignalStrengthNotification() function.
virtual TInt GetBer(TUint& aBer) const=0;
This function retrieves the current Bit Error Rate (BER) information.
TUint& aBer |
On return, contains the current BER information (as a percentage). |
TInt |
An error code: see System error codes. |
virtual void GetBer(TRequestStatus& aStatus, TUint& aBer)=0;
This function retrieves the current Bit Error Rate (BER) information.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TUint& aBer |
On request completion, contains the current BER information (as a percentage). |
virtual void GetBerCancel() const=0;
This function cancels an outstanding bit error rate retrieval request, placed using the asynchronous version of the GetBer() function.
virtual void BerNotification(TRequestStatus& aStatus,TUint& aBer)=0;
This function provides notification when the Bit Error Rate changes.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TUint& aBer |
On request completion, contains the current bit error rate. |
virtual void BerNotificationCancel() const=0;
This function cancels an outstanding Bit Error Rate notification request, placed using the BerNotification() function.
Indicates that signal strength information is available. |
|
Indicates that bit error rate information is available. |
|
Indicates that asynchronous signal strength change notifications are supported. |
|
Indicates that asynchronous bit error rate change notifications are supported. |
TUint iSignalCaps |
A bitmask of TSignalStrengthAndBerCaps constants. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |