Share via

2.2.1.1 Drawing and Desktop Mode Changes Order (TS_COMPDESK_TOGGLE)

  • Article

The server sends the TS_COMPDESK_TOGGLE packet to the client to communicate changes in the drawing mode and in the desktop mode.

The drawing mode indicates whether the desktop composition is turned on. The drawing mode changes as a result of enabling and disabling desktop composition.

The desktop mode indicates whether the current desktop is the one that is being composed if composition is turned on. The desktop mode changes as a result of desktop switch.


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

header

operation

size

eventType

header (1 byte): An 8-bit unsigned integer. An alternate secondary order header, as specified in [MS-RDPEGDI] section 2.2.2.2.1.3.1.1. The embedded order type field MUST be set to TS_ALTSEC_COMPDESK_FIRST (0x0c).

operation (1 byte): An 8-bit unsigned integer. The operation code. This field MUST be set to COMPDESKTOGGLE (0x01).

size (2 bytes): A 16-bit unsigned integer. The size of the order data that follows the size field. This field MUST be set to 0x0001.

eventType (1 byte): An 8-bit unsigned integer. The specific event that is being signaled to the client to change its drawing and desktop mode. It MUST have one of the following values:

Value

Meaning

REDIRMODE_COMPOSITION_OFF

0x00

The server is leaving desktop composition mode.

REDIRMODE_RESERVED_00

0x01

This value is reserved and not used. It SHOULD be ignored if received.

REDIRMODE_RESERVED_01

0x02

This value is reserved and not used. It SHOULD be ignored if received.

REDIRMODE_COMPOSITION_ON

0x03

The server is entering desktop composition mode.

REDIRMODE_DWM_DESK_ENTER

0x04

The server is switching from a non-composed mode desktop to a composed mode desktop.

REDIRMODE_DWM_DESK_LEAVE

0x05

The server is switching from a composed mode to a non-composed mode desktop.