Share via


CELLGPRSQOSSETTINGS

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

Reference

CELLGPRSCONNECTIONINFO

Concepts

Telephony Service Provider Structures