Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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."

Syntax

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

Header tsp.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also