2.2.2.4.8 Shared Window List

The Shared Window List order describes the windows of the sender to the receiver.

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
msg																flags
numWindows																Tick
Token																Reserved
aWindows (variable)
...
windowText (variable)
...
nonRectInfo (variable)
...

msg (2 bytes): MUST be set to 0x0001.

flags (2 bytes): A bitmap of the following value.

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5
0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	S

Where the bits are defined as:

Value	Description
S	The receiver SHOULD resend its entire window list. This message is only sent by Microsoft NetMeeting 2.x clients.

Bits marked "0" MUST be ignored.

numWindows (2 bytes): The number of SWLWINATTRIBUTES structures in the aWindows field.

Tick (2 bytes): The time the message was generated, which is specified as the number of milliseconds since the sending computer was started.

Token (2 bytes): The sequence number that is incremented with each window list message that is sent. Only NetMeeting 2.x clients look at this value.

Reserved (2 bytes): Reserved. MUST be set to zero when sent and MUST be ignored on receipt.

aWindows (variable): An array of SWLWINATTRIBUTES structures that describe the properties of each window. The length of this field is specified by numWindows.

windowText (variable): An array of null-terminated ASCII strings that indicate the window titles of each shared window.

Titles consist of null-terminated strings of up to SWL_MAX_WINDOW_TITLE_SEND characters; SWL_MAX_WINDOW_TITLE_SEND is 50. If the title is NULL, the string is 0x00FF.

Titles appear in the same order as the corresponding windows in the SWLWINATTRIBUTES structure. Windows MUST only be shown on the shared-application taskbar of the client if the SWL_FLAG_WINDOW_HOSTED and SWL_FLAG_WINDOW_TASKBAR flags in SWLWINATTRIBUTES are set.

nonRectInfo (variable): If a window has a nonrectangular shape, this field contains nonrectangular data in a SWLPACKETCHUNK structure.

The list of windows has an associated z-order that can be used to divide the viewer window of the receiver into the following region types.

• Any portion of a shared window that is not covered by an obscuring window results in a region of the client viewer that visibly shows graphics data from the host.

• Any portion of an obscuring window that covers up a shared window results in a region of the client viewer that is obscured.

• Any portion of the desktop of the sender that is not shared or obscured is represented as a non-shared area.

The list that is sent can be either the full list of shared and obscuring windows, or simply updates to the existing list.