2.2.2.2 DISPLAYCONTROL_MONITOR_LAYOUT_PDU

The DISPLAYCONTROL_MONITOR_LAYOUT_PDU message is a client-to-server PDU that is used to request a display configuration change on the server, such as the addition of a monitor or a new resolution for an existing monitor. Note that the entire monitor layout MUST be included in the Monitors field even if the configuration of only a single monitor is updated.


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

...

MonitorLayoutSize

NumMonitors

Monitors (variable)

...

Header (8 bytes): A DISPLAYCONTROL_HEADER (section 2.2.1.1) structure. The Type field MUST be set to DISPLAYCONTROL_PDU_TYPE_MONITOR_LAYOUT (0x00000002).

MonitorLayoutSize (4 bytes): A 32-bit unsigned integer that specifies the size, in bytes, of a single element in the Monitors field. This field MUST be set to 40 bytes, the size of the DISPLAYCONTROL_MONITOR_LAYOUT structure (section 2.2.2.2.1).

NumMonitors (4 bytes): A 32-bit unsigned integer that specifies the number of display monitor definitions in the Monitors field.  The maximum number of monitor definitions allowed is specified in the MaxNumMonitors field of the DISPLAYCONTROL_CAPS_PDU (section 2.2.2.1) message.

Monitors (variable): A variable-length array containing a series of DISPLAYCONTROL_MONITOR_LAYOUT structures that specify the display monitor layout of the client. The number of DISPLAYCONTROL_MONITOR_LAYOUT structures is specified by the NumMonitors field. The area (in square pixels) of the layout specified by the DISPLAYCONTROL_MONITOR_LAYOUT structures MUST NOT exceed the maximum monitor area defined by the server in the DISPLAYCONTROL_CAPS_PDU message.

Show: