ATM_FLOW_PARAMETERS structure

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

The ATM_FLOW_PARAMETERS structure specifies ATM-specific flow parameters.

Syntax

typedef struct _ATM_FLOW_PARAMETERS {
  ATM_SERVICE_CATEGORY ServiceCategory;
  ULONG                AverageCellRate;
  ULONG                PeakCellRate;
  ULONG                MinimumCellRate;
  ULONG                InitialCellRate;
  ULONG                BurstLengthCells;
  ULONG                MaxSduSize;
  ULONG                TransientBufferExposure;
  ULONG                CumulativeRMFixedRTT;
  UCHAR                RateIncreaseFactor;
  UCHAR                RateDecreaseFactor;
  USHORT               ACRDecreaseTimeFactor;
  UCHAR                MaximumCellsPerForwardRMCell;
  UCHAR                MaximumForwardRMCellInterval;
  UCHAR                CutoffDecreaseFactor;
  UCHAR                Reserved1;
  ULONG                MissingRMCellCount;
  ULONG                Reserved2;
  ULONG                Reserved3;
} ATM_FLOW_PARAMETERS, *PATM_FLOW_PARAMETERS;

Members

• ServiceCategory
  Specifies the ATM service category as one of the following values:

  • ATM_SERVICE_CATEGORY_CBR
    Constant Bit Rate

  • ATM_SERVICE_CATEGORY_VBR
    Variable Bit Rate

  • ATM_SERVICE_CATEGORY_UBR
    Unspecified Bit Rate

  • ATM_SERVICE_CATEGORY_ABR
    Available Bit Rate

• AverageCellRate
  Specifies in cells per second the average rate at which cells are to be sent on this connection.

• PeakCellRate
  Specifies in cells per second the peak rate at which cells are to be sent on this connection.

• MinimumCellRate
  Specifies in cells per second the minimum cell rate at which cells are to be sent on this connection. This is an ABR service parameter.

• InitialCellRate
  Specifies in cells per second the initial cell rate at which cells are to be sent on this connection. This is an ABR service parameter.

• BurstLengthCells
  Specifies the number of consecutive cells sent at the peak cell rate. If AverageCellRate equals PeakCellRate, this parameter can be ignored and the effective burst length is infinite.

• MaxSduSize
  Specifies in bytes the size of the maximum Service Data Unit that will be sent or received on this VC.

• TransientBufferExposure
  Specifies the Transient Buffer Exposure, which is the number of cells that can be sent during the startup period before the first RM-cell (Resource Management cell) returns. This is an ABR service parameter.

• CumulativeRMFixedRTT
  Specifies in microseconds the Fixed Roundtrip Time, which is the sum of the fixed and propagation delays from the source to the furthest destination and back. This is an ABR service parameter.

• RateIncreaseFactor
  Specifies the Rate Increase Factor, which controls the amount by which the cell transmission rate may increase upon receipt of an RM-cell. AIR =PCR*RIF (Additive Increase Rate = Peak Cell Rate * Rate Increase Factor). RIF is a power of 2, ranging from 1/32768 to 1. This is an ABR service parameter.

• RateDecreaseFactor
  Specifies the Rate Decrease Factor, which controls the decrease in the cell transmission rate. RDF is a power of 2 from 1/32,768 to 1. This is an ABR service parameter.

• ACRDecreaseTimeFactor
  Specified ACR Decrease Time Factor, which is the time permitted between sending RM-cells before the rate is decreased to ICR (Initial Cell Rate). The ADTF range is .01 to 10.23 seconds with a granularity of 10 ms. This is an ABR service parameter.

• MaximumCellsPerForwardRMCell
  Specifies the Nrm, which is the maximum number of cells a source may send for each forward RM-cell. This is an ABR service parameter.

• MaximumForwardRMCellInterval
  Specifies the Trm, which provides an upper bound on the time between forward RM-cells for an active source. It is 100 times a power of two with a range of 100*2-7 to 100*20. This is an ABR service parameter.

• CutoffDecreaseFactor
  Specifies the Cutoff Decrease Factor (CDF), which controls the decrease in ACR (Allowed Cell Rate) associated with Cell Rate Margin (CRM). This is an ABR service parameter.

• Reserved1
  This is reserved.

• MissingRMCellCount
  Specifies the Cell Rate Margin (CRM), which is the difference between the effective bandwidth allocation and the allocation for sustainable rate in cells per second. This is an ABR service parameter.

• Reserved2
  This is reserved.

• Reserved3
  This is reserved.

Remarks

The ATM_MEDIA_PARAMETERS structure and the Q2931_ADD_PVC structure each contain two ATM_FLOW_PARAMETERS structures. One of the ATM_FLOW_PARAMETERS structures specifies transmit flow parameters; the other specifies receive flow parameters.

Requirements

Header

Atm.h (include Atm.h)

See also

ATM_MEDIA_PARAMETERS

Q2931_ADD_PVC

 

 

Send comments about this topic to Microsoft