2.2.1.3.1.2.1 New or Existing Window

Artigo
06/24/2021

A Window Information Order is generated by the server whenever a new window is created on the server or when a property on a new or existing window is updated. The window metrics sent in this order are illustrated in the "An illustration of the window metrics sent in the Window Information Order" figure in section 3.3.5.1.6.

0	8	6	4
Hdr
...
...			OwnerWindowId (optional)
...			Style (optional)
...			ExtendedStyle (optional)
...			ShowState (optional)
TitleInfo (variable)
...
ClientOffsetX (optional)
ClientOffsetY (optional)
ClientAreaWidth (optional)
ClientAreaHeight (optional)
WindowLeftResizeMargin (optional)
WindowRightResizeMargin (optional)
WindowTopResizeMargin (optional)
WindowBottomResizeMargin (optional)
RPContent (optional)	RootParentHandle (optional)
...	WindowOffsetX (optional)
...	WindowOffsetY (optional)
...	WindowClientDeltaX (optional)
...	WindowClientDeltaY (optional)
...	WindowWidth (optional)
...	WindowHeight (optional)
...	NumWindowRects (optional)		WindowRects (variable)
...
VisibleOffsetX (optional)
VisibleOffsetY (optional)
NumVisibilityRects (optional)		VisibilityRects (variable)
...
OverlayDescription (variable)
...
TaskbarButton (optional)	EnforceServerZOrder (optional)	AppBarState (optional)	AppBarEdge (optional)

Hdr (11 bytes): Eleven bytes. Common Window AltSec Order header, TS_WINDOW_ORDER_HEADER. The FieldsPresentFlags field of the header MUST conform to the values defined as follows.

Value	Meaning
0x01000000 WINDOW_ORDER_TYPE_WINDOW	Indicates a Windowing Alternate Secondary Drawing Order describing a window. This flag MUST be set.
0x10000000 WINDOW_ORDER_STATE_NEW	Indicates that the Windowing Alternate Secondary Drawing Order contains information for a new window. If this flag is not set, the order contains information for an existing window.
0x00000002 WINDOW_ORDER_FIELD_OWNER	Indicates that the OwnerWindowId field is present.
0x00000008 WINDOW_ORDER_FIELD_STYLE	Indicates that the Style and ExtendedStyle fields are present.
0x00000010 WINDOW_ORDER_FIELD_SHOW	Indicates that the ShowState field is present.
0x00000004 WINDOW_ORDER_FIELD_TITLE	Indicates that the TitleInfo field is present.
0x00004000 WINDOW_ORDER_FIELD_CLIENTAREAOFFSET	Indicates that the ClientOffsetX and ClientOffsetY fields are present.
0x00010000 WINDOW_ORDER_FIELD_CLIENTAREASIZE	Indicates that the ClientAreaWidth and ClientAreaHeight fields are present.<3>
0x00000080 WINDOW_ORDER_FIELD_RESIZE_MARGIN_X	Indicates that the WindowLeftResizeMargin and WindowRightResizeMargin fields are present.
0x08000000 WINDOW_ORDER_FIELD_RESIZE_MARGIN_Y	Indicates that the WindowTopResizeMargin and WindowBottomResizeMargin fields are present.
0x00020000 WINDOW_ORDER_FIELD_RPCONTENT	Indicates that the RPContent field is present. <4>
0x00040000 WINDOW_ORDER_FIELD_ROOTPARENT	Indicates that the RootParentHandle field is present. <5>
0x00000800 WINDOW_ORDER_FIELD_WNDOFFSET	Indicates that the WindowOffsetX and WindowOffsetY fields are present.
0x00008000 WINDOW_ORDER_FIELD_CLIENTDELTA	Indicates that the WindowClientDeltaX and WindowClientDeltaY fields are present.
0x00000400 WINDOW_ORDER_FIELD_WNDSIZE	Indicates that the WindowWidth and WindowHeight fields are present.
0x00000100 WINDOW_ORDER_FIELD_WNDRECTS	Indicates that the NumWindowRects and WindowRects fields are present.
0x00001000 WINDOW_ORDER_FIELD_VISOFFSET	Indicates that the VisibleOffsetX and VisibleOffsetY fields are present.
0x00000200 WINDOW_ORDER_FIELD_VISIBILITY	Indicates that the NumVisibilityRects and VisibilityRects fields are present.
0x00400000 WINDOW_ORDER_FIELD_OVERLAY_DESCRIPTION	Indicates that the OverlayDescription field is present.
0x00200000 WINDOW_ORDER_FIELD_ICON_OVERLAY_NULL	Indicates that a taskbar overlay icon previously set by the window has been removed.
0x00800000 WINDOW_ORDER_FIELD_TASKBAR_BUTTON	Indicates that the TaskbarButton field is present.
0x00080000 WINDOW_ORDER_FIELD_ENFORCE_SERVER_ZORDER	Indicates that the EnforceServerZOrder field is present.
0x00000040 WINDOW_ORDER_FIELD_APPBAR_STATE	Indicates that the AppBarState field is present.
0x00000001 WINDOW_ORDER_FIELD_APPBAR_EDGE	Indicates that the AppBarEdge field is present.

OwnerWindowId (4 bytes): An unsigned 32-bit integer. The ID of the window on the server that is the owner of the window specified in WindowId field of Hdr. For more information on owned windows, see [MSDN-WINFEATURE]. This field is present if and only if the WINDOW_ORDER_FIELD_OWNER flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

Style (4 bytes): An unsigned 32-bit integer. Describes the window's current style. Window styles determine the appearance and behavior of a window. For more information, see [MSDN-WINSTYLE]. This field is present if and only if the WINDOW_ORDER_FIELD_STYLE flag is set in the FieldsPresentFlags field of the TS_WINDOW_ORDER_HEADER.

ExtendedStyle (4 bytes): An unsigned 32-bit integer. Extended window style information. For more information about extended window styles, see [MSDN-CREATEWINEX].

This field is present if and only if the WINDOW_ORDER_FIELD_STYLE flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

ShowState (1 byte): An unsigned 8-bit integer. Describes the show state of the window.

This field is present if and only if the WINDOW_ORDER_FIELD_SHOW flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

The field MUST be one of the following values.

Value	Meaning
0x00	Do not show the window.
0x02	Show the window minimized.
0x03	Show the window maximized.
0x05	Show the window in its current size and position.

TitleInfo (variable): UNICODE_STRING. Variable length. Contains the window's title string. This string is not guaranteed to be null-terminated. The maximum value for the CbString field of UNICODE_STRING is 520 bytes. This structure is present only if the WINDOW_ORDER_FIELD_TITLE flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

ClientOffsetX (4 bytes): A 32-bit signed integer. The X (horizontal) offset from the top-left corner of the screen to the top-left corner of the window's client area, expressed in screen coordinates.

This field is present only if the WINDOW_ORDER_FIELD_CLIENTAREAOFFSET flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

ClientOffsetY (4 bytes): A 32-bit signed integer. The Y (vertical) offset from the top-left corner of the screen to the top-left corner of the window's client area, expressed in screen coordinates.

This field is present only if the WINDOW_ORDER_FIELD_CLIENTAREAOFFSET flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

ClientAreaWidth (4 bytes): An unsigned 32-bit integer specifying the width of the client area rectangle of the target window.

This field only appears if the WndSupportLevel field of the Window List Capability Set message is set to TS_WINDOW_LEVEL_SUPPORTED_EX (as specified in section 2.2.1.1.2) and the WINDOW_ORDER_FIELD_CLIENTAREASIZE flag is set in the FieldsPresentFlags field of the TS_WINDOW_ORDER_HEADER packet (section 2.2.1.3.1.1).

ClientAreaHeight (4 bytes): An unsigned 32-bit integer specifying the height of the client area rectangle of the target window.

This field only appears if the WndSupportLevel field of the Window List Capability Set message is set to TS_WINDOW_LEVEL_SUPPORTED_EX (as specified in section 2.2.1.1.2) and the Hdr field has the WINDOW_ORDER_FIELD_CLIENTAREASIZE flag is set in the FieldsPresentFlags field of the TS_WINDOW_ORDER_HEADER packet (section 2.2.1.3.1.1).

WindowLeftResizeMargin (4 bytes): An unsigned 32-bit integer specifying the width of the transparent hit-testable margin along the left edge of the window. Any mouse, pen, or touch input within this margin SHOULD be sent to the server.

This field is present only if the WINDOW_ORDER_FIELD_RESIZE_MARGIN_X flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

Resize margins SHOULD be used to extend the window geometry (defined by the WindowOffsetX, WindowOffsetY, WindowWidth and WindowHeight fields) and are not included in the window boundaries.

WindowRightResizeMargin (4 bytes): An unsigned 32-bit integer specifying the width of the transparent hit-testable margin along the right edge of the window. Any mouse, pen or touch input within this margin SHOULD be sent to the server.

This field is present only if the WINDOW_ORDER_FIELD_RESIZE_MARGIN_X flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowTopResizeMargin (4 bytes): An unsigned 32-bit integer specifying the height of the transparent hit-testable margin along the top edge of the window. Any mouse, pen or touch input within this margin SHOULD be sent to the server.

This field is present only if the WINDOW_ORDER_FIELD_RESIZE_MARGIN_Y flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowBottomResizeMargin (4 bytes): An unsigned 32-bit integer specifying the height of the transparent hit-testable margin along the bottom edge of the window. Any mouse, pen or touch input within this margin SHOULD be sent to the server.

This field is present only if the WINDOW_ORDER_FIELD_RESIZE_MARGIN_Y flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

RPContent (1 byte): An unsigned BYTE that MUST be set to one of the following possible values.

Value	Meaning
0x00	The window is not used by a render plug-in to do client-side rendering.
0x01	The window is used by a render plug-in to do client-side rendering.

This field only appears if the WndSupportLevel field of the Window List Capability Set message is set to TS_WINDOW_LEVEL_SUPPORTED_EX (as specified in section 2.2.1.1.2) and the Hdr field has the WINDOW_ORDER_FIELD_RPCONTENT flag is set in the FieldsPresentFlags field of the TS_WINDOW_ORDER_HEADER packet (section 2.2.1.3.1.1).

RootParentHandle (4 bytes): An unsigned 32-bit integer specifying the server-side target window's top-level parent window handle. A Top-Level parent window is the window immediately below "desktop" in the window hierarchy. If the target window is a top-level window, the window handle of the target window is sent.

This field only appears if the WndSupportLevel field of the Window List Capability Set message is set to TS_WINDOW_LEVEL_SUPPORTED_EX (as specified in section 2.2.1.1.2) and the Hdr field has the WINDOW_ORDER_FIELD_ROOTPARENT flag is set in the FieldsPresentFlags field of the TS_WINDOW_ORDER_HEADER packet (section 2.2.1.3.1.1).

WindowOffsetX (4 bytes): A 32-bit signed integer. The X (horizontal) offset from the top-left corner of the primary monitor to the top-left corner of the window, expressed in screen coordinates.

This field is present only if the WINDOW_ORDER_FIELD_WNDOFFSET flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowOffsetY (4 bytes): A 32-bit signed integer. The Y (vertical) offset from the top-left corner of the primary monitor to the top-left corner of the window, expressed in screen coordinates.

This field is present only if the WINDOW_ORDER_FIELD_WNDOFFSET flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowClientDeltaX (4 bytes): A 32-bit signed integer. The X (horizontal) delta between the top-left corner of the window and the window's client area.

This field is present only if the WINDOW_ORDER_FIELD_CLIENTDELTA flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowClientDeltaY (4 bytes): A 32-bit signed integer. The Y (vertical) delta between the top-left corner of the window and the window's client area.

This field is present only if the WINDOW_ORDER_FIELD_CLIENTDELTA flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowWidth (4 bytes): An unsigned 32-bit integer. The window width, in screen coordinates.

This field is present only if the WINDOW_ORDER_FIELD_WNDSIZE flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowHeight (4 bytes): An unsigned 32-bit integer. The window height, in screen coordinates.

This field is present only if the WINDOW_ORDER_FIELD_WNDSIZE flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

NumWindowRects (2 bytes): An unsigned 16-bit integer. A count of rectangles describing the window geometry.

This field is present only if the WINDOW_ORDER_FIELD_WNDRECTS flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

WindowRects (variable): An array of TS_RECTANGLE_16 structures, NumWindowRects wide, describing the window geometry. All coordinates are window coordinates.

This field is present only if the NumWindowRects field is greater than 0 and the WINDOW_ORDER_FIELD_WNDRECTS flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

VisibleOffsetX (4 bytes): A 32-bit signed integer. The X (horizontal) offset from the top-left corner of the screen to the top-left corner of the window visible region's bounding rectangle, expressed in screen coordinates.<6>

This field is present only if the WINDOW_ORDER_FIELD_VISOFFSET flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

VisibleOffsetY (4 bytes): A 32-bit signed integer. The Y (vertical) offset from the top-left corner of the screen to the top-left corner of the window visible region's bounding rectangle, expressed in screen coordinates.<7>

This field is present only if the WINDOW_ORDER_FIELD_VISOFFSET flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

NumVisibilityRects (2 bytes): An unsigned 16-bit integer. A count of rectangles describing the window visible region.

This field is present only if the WINDOW_ORDER_FIELD_VISIBILITY flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

VisibilityRects (variable): An array of TS_RECTANGLE_16 structures, NumVisibilityRects wide, describing the window visible region. All coordinates are window coordinates.

This field is present only if the value of the NumVisibilityRects field is greater than 0 and the WINDOW_ORDER_FIELD_VISIBILITY flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

OverlayDescription (variable, optional): A variable length UNICODE_STRING (section 2.2.1.2.1) that contains the description text for the window's overlay icon (see sections 2.2.1.3.1.2.2 and 2.2.1.3.1.2.3).

This field is present only if the WINDOW_ORDER_FIELD_OVERLAY_DESCRIPTION flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

TaskbarButton (1 byte, optional): An 8-bit unsigned integer. If this field is set to 0x00, then the client SHOULD add a tab to the taskbar button group for the window, if supported by the operating system, instead of adding a new taskbar button for the window. If this field is set to 0x01, then the client SHOULD remove the tab from the taskbar button group for the window.

Windows share a taskbar button group if they have matching Application IDs, as specified by the Server Get Application ID Response PDU (section 2.2.2.8.1).

This field is present only if the WINDOW_ORDER_FIELD_TASKBAR_BUTTON flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

EnforceServerZOrder (1 byte, optional): An 8-bit unsigned integer. If this field is set to 0x01, then the client SHOULD order this window, and all other windows in the Z-order list (in the Actively Monitored Desktop packet, as specified in section 2.2.1.3.3.2.1) that also have the field set consecutively per the Z-order hierarchy. The client SHOULD NOT attempt to reorder these windows with respect to each other, or to move any window between the windows in this group.

If this field is set to 0x00, then no special Z-order handling is required.

This field is present only if the WINDOW_ORDER_FIELD_ENFORCE_SERVER_ZORDER flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

AppBarState (1 byte, optional): An 8-bit unsigned integer. If this field is set to 0x01, then the window SHOULD be registered as an application desktop toolbar. If this field is set to 0x00, then the application desktop toolbar SHOULD be deregistered.

This field is present only if the WINDOW_ORDER_FIELD_APPBAR_STATE flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

AppBarEdge (1 byte, optional): An 8-bit unsigned integer. The value of this field indicates the edge to which the application desktop toolbar SHOULD be anchored. This field MUST be set to one of the following possible values.

Value	Meaning
0x00	Anchor to the left edge.
0x01	Anchor to the top edge.
0x02	Anchor to the right edge.
0x03	Anchor to the bottom edge.

This field is present only if the WINDOW_ORDER_FIELD_APPBAR_EDGE flag is set in the FieldsPresentFlags field of TS_WINDOW_ORDER_HEADER.

Compartilhar via

2.2.1.3.1.2.1 New or Existing Window

Recursos adicionais