2.2.2.12.1 Window Cloak State Change PDU (TS_RAIL_ORDER_CLOAK)

Windows are either in a cloaked or uncloaked state. Changes in the cloak state of a RAIL window on the client, or a remoted window on the server, are communicated by Window Cloak State Change PDU.

The client sends the Window Cloak State Change PDU if both the client and server support syncing per-window cloak state (indicated by the TS_RAIL_LEVEL_WINDOW_CLOAKING_SUPPORTED flag in the Remote Programs Capability Set (section 2.2.1.1.1)). The server uses this information to sync the cloak state to the associated window on the server.

The server sends the Window Cloak State Change PDU if the client is capable of processing this PDU (indicated by the TS_RAIL_CLIENTSTATUS_BIDIRECTIONAL_CLOAK_SUPPORTED flag in the Client Information PDU (section 2.2.2.2.2)). The client uses this information to sync the cloak state to the associated window on the client.


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

Hdr

WindowId

Cloaked

Hdr (4 bytes): A TS_RAIL_PDU_HEADER structure. The orderType field of the header MUST be set to TS_RAIL_ORDER_CLOAK (0x0015).

WindowId (4 bytes): An unsigned 32-bit integer. The ID of the window that is to be cloaked or uncloaked.

Cloaked (1 byte): An unsigned 8-bit integer that indicates whether the window SHOULD be cloaked or uncloaked.

Value

Meaning

0x00

The window SHOULD be uncloaked.

0x01

The window SHOULD be cloaked.