Share via


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

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.