2.2.2.4.8 Shared Window List
The Shared Window List order describes the windows of the sender to the receiver.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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
91
0
1
2
3
4
50
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.