2.2.14.2.2 Bandwidth Measure Results (RDP_BW_RESULTS)

The RDP_BW_RESULTS structure is used to send the results of a bandwidth measurement operation to the initiating end-point. Bandwidth measurement is started by the initiating end-point using the Bandwidth Measure Start (section 2.2.14.1.2) message and stopped by the same end-point using the Bandwidth Measure Stop (section 2.2.14.1.4) message. During the RDP Connection Sequence (section 1.3.1.1) payloads of random data are transmitted by the initiating end-point using a sequence of Bandwidth Measure Payload (section 2.2.14.1.3) messages (sent between the start and stop messages). After the RDP Connection Sequence, the PDUs sent from server to client (between start and stop messages) replace the payload messages.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

headerLength

headerTypeId

sequenceNumber

responseType

timeDelta

...

byteCount

...

headerLength (1 byte): An 8-bit unsigned integer that specifies the size, in bytes, of the header data. This field MUST be set to 0x0E.

headerTypeId (1 byte): An 8-bit unsigned integer that specifies the high-level type. This field MUST be set to TYPE_ID_AUTODETECT_RESPONSE (0x01).

sequenceNumber (2 bytes): A 16-bit unsigned integer that specifies the message sequence number. This field SHOULD be set to the same value as the sequenceNumber field of the most recent Bandwidth Measure Stop (section 2.2.14.1.4) message received from the server.

responseType (2 bytes): A 16-bit unsigned integer that specifies a response type code. This field MUST be set to one of the following values.

Value

Meaning

0x0003

The Bandwidth Measure Results message is encapsulated in the autoDetectReqPduData field of an Auto-Detect Request PDU (section 2.2.14.3) sent during the Optional Connect-Time Auto-Detection phase of the RDP Connection Sequence (see section 1.3.1.1 for an overview of the RDP Connection Sequence phases).

0x000B

One of two possible meanings:

  • The Bandwidth Measure Results message is encapsulated in the autoDetectReqPduData field of an Auto-Detect Request PDU (section 2.2.14.3) sent after the RDP Connection Sequence has completed.

  • The Bandwidth Measure Results message is encapsulated in the SubHeaderData field of an RDP_TUNNEL_SUBHEADER ([MS-RDPEMT] section 2.2.1.1.1) structure.

timeDelta (4 bytes): A 32-bit unsigned integer that specifies the time delta, in milliseconds, between the receipt of the Bandwidth Measure Start and the Bandwidth Measure Stop messages.

byteCount (4 bytes): A 32-bit unsigned integer that specifies the total data received in the Bandwidth Measure Payload messages.