CELLGPRSQOSSETTINGS

This structure contains General Packet Radio Service (GPRS) Quality Of Service (QOS) settings that are used to specify minimum and requested QOS settings. The QOS defines the quality of service expected for a GPRS packet. For more information, see GSM specification 02.60 "Digital cellular telecommunications system (Phase 2+); enhanced Multi-Level Precedence and Pre-emption service (eMLPP) - Stage 1."

typedef struct cellgprsqossettings_tag {
DWORD dwPrecedenceClass;
DWORD dwDelayClass;
DWORD dwReliabilityClass;
DWORD dwPeakThruClass;
DWORD dwMeanThruClass;
} CELLGPRSQOSSETTINGS, *LPCELLGPRSQOSSETTINGS;

Members

• dwPrecedenceClass
  Identifies the GPRS precedence class, which indicates packet priority. The network uses this setting to prioritize service under abnormal conditions. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_ GPRSPRECEDENCECLASS_UNKNOWN	Unknown priority.
  CELLDEVCONFIG_ GPRSPRECEDENCECLASS_SUBSCRIBED	The subscribed value is stored in the network.
  CELLDEVCONFIG_ GPRSPRECEDENCECLASS_HIGH	High priority. Service will be maintained above all other precedence levels.
  CELLDEVCONFIG_ GPRSPRECEDENCECLASS_NORMAL	Normal priority. Service will be maintained above low precedence level.
  CELLDEVCONFIG_ GPRSPRECEDENCECLASS_LOW	Low priority. Service will be maintained after the high and normal priority commitments are fulfilled.

• dwDelayClass
  Identifies the delay class. The delay class identifies the maximum delay intervals for a packet during transmission on an internal network. This information is required for real-time traffic. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_GPRSDELAYCLASS_ UNKNOWN	Unknown delay class.
  CELLDEVCONFIG_GPRSDELAYCLASS_ SUBSCRIBED	The subscribed value is stored in the network.
  CELLDEVCONFIG_GPRSDELAYCLASS_ PREDICTIVE1	For a secure data unit (SDU) of 128 octets, mean transfer delay of <0.5 seconds and 95 percentile delay of <1.5 seconds. For an SDU of 1024 octets, mean transfer delay of <2 seconds and 95 percentile delay of <7 seconds.
  CELLDEVCONFIG_GPRSDELAYCLASS_ PREDICTIVE2	For an SDU of 128 octets, mean transfer delay of <5 seconds and 95 percentile delay of <25 seconds. For an SDU of 1024 octets, mean transfer delay of <15 seconds and 95 percentile delay of <75 seconds.
  CELLDEVCONFIG_GPRSDELAYCLASS_ PREDICTIVE3	For an SDU of 128 octets, mean transfer delay of <50 seconds and 95 percentile delay of <250 seconds. For an SDU of 1024 octets, mean transfer delay of <75 seconds and 95 percentile delay of <375 seconds.
  CELLDEVCONFIG_GPRSDELAYCLASS_ BESTEFFORT	Best effort.

• dwReliabilityClass
  Identifies the reliability class of a packet. The requirements of network protocol layers are identified in the reliability class. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_UNKNOWN	Unknown reliability class.
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_SUBSCRIBED	The subscribed value is stored in the network.
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_1	The application is error-sensitive and cannot handle data loss. Do not send real-time traffic.
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_2	The application is error-sensitive and can handle infrequent data loss. Do not send real-time traffic.
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_3	The application is error-sensitive and can handle data loss, GMM/SM, and short message service (SMS). Do not send real-time traffic.
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_4	The application is error-sensitive and can handle data loss. Real-time traffic may be sent. (Requires appropriate settings for delay and throughput.)
  CELLDEVCONFIG_ GPRSRELIABILITYCLASS_5	The application is not error-sensitive and can handle data loss. Real-time traffic may be sent. (Requires appropriate settings for delay and throughput.)

• dwPeakThruClass
  Identifies the peak throughput class, which specifies the expected data transfer rate across the network in bits per second. This setting is independent of the delay class. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_PEAKTHRUCLASS_ UNKNOWN	Unknown peak throughput class.
  CELLDEVCONFIG_PEAKTHRUCLASS_ SUBSCRIBED	The subscribed value is stored in the network.
  CELLDEVCONFIG_PEAKTHRUCLASS_8000	8 kilobits per second (kbps)
  CELLDEVCONFIG_PEAKTHRUCLASS_16000	16 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_32000	32 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_64000	64 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_128000	128 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_256000	256 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_512000	512 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_1024000	1,024 kbps
  CELLDEVCONFIG_PEAKTHRUCLASS_2048000	2,048 kbps

• dwMeanThruClass
  Identifies the mean throughput class, which specifies the average data transfer rate across the GPRS network in octets per hour. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_MEANTHRUCLASS_ UNKNOWN	Unknown mean throughput class.
  CELLDEVCONFIG_MEANTHRUCLASS_ SUBSCRIBED	The subscribed value is stored in the network
  CELLDEVCONFIG_MEANTHRUCLASS_100	100 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_200	200 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_500	500 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_1000	1,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_2000	2,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_5000	5,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_10000	10,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_20000	20,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_50000	50,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_100000	100,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_200000	200,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_500000	500,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_1000000	1,000,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_2000000	2,000,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_5000000	5,000,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_10000000	10,000,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_20000000	20,000,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_50000000	50,000,000 octets per hour
  CELLDEVCONFIG_MEANTHRUCLASS_ DONTCARE	Best effort

Remarks

This is used to specify the quality of service parameters on a GPRS context.

The mean throughput class is measured in octets per hour. The peak throughput class is measured in bits per second.

Requirements

Smartphone Platforms: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: tsp.h
Library: cellcore.lib

See Also

CELLGPRSCONNECTIONINFO

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.