CELLGPRSQOSSETTINGS (Windows Embedded CE 6.0)
1/6/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 |