RPacketQoS Class Reference

Standard constructor.

Closes the client's current sub-session with ETel.

Any outstanding requests the client may have with ETel (notifications, for example) will be automatically destroyed by ETel.

This function creates an instance of CPacketQoSPtrHolder and assigns it to the iEtelPacketQoSPtrHolder pointer.

This function deletes and NULLs the iEtelPacketQoSPtrHolder pointer.

Gets the Quality of Service capabilities for the current packet service.

Depending on the the packet service type, a TQoSCapsGPRS, TQoSCapsCDMA2000, TQoSCapsR99_R4 or TQoSCapsR5 will be passed in. The TSY will assign a bitmask for each parameter in the relevant TQoSCapsxxx class. This bitmask contains all values which can be assigned to the particular parameter for the current packet service and phone.

This is an asynchronous function.

The TQoSCapsxxxx classes inherit from TPacketDataConfigBase and therefore contain iExtensionId member data identifying the configuration class (GPRS Rel97/98, CDMA, Rel99 or Rel4).

To determine how to correctly unpack the descriptor once it reaches the TSY, the TSY must first cast the descriptor to a TPacketDataConfigBase pointer and check whether the value of the iExtensionId parameter. Depending on this value, the TSY will then cast the descriptor to the correct TPacketDataConfigBase-derived class.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketQoSGetProfileCaps) to cancel a previously placed asynchronous GetProfileCapabilities() request.

Retrieves the TSY/phone values of all parameters associated with a negotiated QoS profile.

This is an asynchronous function.

QoS profile parameters are contained as member data in either a TQoSGPRSNegotiated, TQoSCDMA2000Negotiated, or TQoSR99_R4Negotiated class, depending on the current packet service. These T-classes are packaged inside a TPckg<> template class, enabling them to be passed as a descriptor to the TSY.

The Negotiated QoS profile class derives from TPacketDataConfigBase and therefore contains iExtensionId member data identifying whether it is a GPRS, CDMA or R99_4 configuration class. To determine how to correctly unpack the descriptor once it reaches the TSY, the TSY must first cast the descriptor to a TPacketDataConfigBase pointer and check whether the value of the iExtensionId parameter. Depending on this value, the TSY will then cast the descriptor to the correct TPacketDataConfigBase-derived class.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketQoSGetProfileParams) to cancel a previously placed asynchronous GetProfileParameters() request.

Notifies a client of a change in the negotiated QoS profile is received by the TSY from the phone.

This is a asynchronous function.

The new QoS profile returned will be either TQoSGPRSNegotiated, TQoSCDMA2000Negotiated or TQoSR99_R4Negotiated, depending on the current packet service. The TQoSxxxNegotiated class will contain updated values for each QoS parameter.

If the client wishes to receive further notifications, NotifyProfileChanged() must be called again.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketQoSNotifyProfileChanged) to cancel a previously placed asynchronous NotifyProfileChanged() request.

Opens a handle on an existing RPacketQoS object identified by the profile name.

An opened RPacketContext must be closed explicitely by calling Close() to prevent a resource (memory) leak.

Creates a new QoS profile (i.e. RPacketQoS class instance).

An RPacketQoS may only be opened on an existing RPacketContext subsession.

When the new QoS profile is created, the TSY will assign it a unique name to it. The client can use this name to uniquely identify the particular context.

An opened RPacketContext must be closed explicitely by calling Close() to prevent a resource (memory) leak.

Passes to the TSY all the parameters required to configure Quality of Service for a particular context.

The parameters are passed via a TQoSGPRSRequested, TQoSCDMA2000Requested or TQoSRequestedR99_R4 class, depending on the current network and packet-service.

This is an asynchronous function call.

The TQoSCapsxxxx classes inherit from TPacketDataConfigBase and therefore contain an iExtensionId member data identifying whether they are a GPRS, CDMA or R99_R4 configuration class.

To determine how to correctly unpack the descriptor once it reaches the TSY, the TSY must first cast the descriptor to a TPacketDataConfigBase pointer and check the value of the iExtensionId parameter. Referring to this value the TSY will then cast the descriptor to the correct TPacketDataConfigBase- derived class.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketQoSSetProfileParams) to cancel a previously placed asynchronous SetProfileParameters() request.