Share via


2.2.7.52 MILCMD_TARGET_UPDATEWINDOWSETTINGS

The MILCMD_TARGET_UPDATEWINDOWSETTINGS packet updates how this rendering target interacts with the window to which it is drawing.


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

messageSize

controlCode

targetResource

windowRect (16 bytes)

...

...

windowLayerType

transparencyMode

constantAlpha

isChild

isRTL

renderingEnabled

colorKey (16 bytes)

...

...

disableCookie

messageSize (4 bytes): A 32-bit unsigned integer. The size of this message in bytes. The value of this field MUST be set to 0x00000048.

controlCode (4 bytes): A 32-bit unsigned integer containing the control code for this message. The value of this field MUST be equal to 0x00000043.

targetResource (4 bytes): A 32-bit unsigned integer. The value of this field MUST be set to a valid resource handle referencing a resource of type TYPE_HWNDRENDERTARGET, TYPE_DESKTOPRENDERTARGET, or TYPE_METABITMAPRENDERTARGET. This handle identifies the resource that is the target for this message.

windowRect (16 bytes): A MilRectI structure. This rectangle will be treated as the new window rectangle for the window associated with the rendering target specified by the targetResource field.

windowLayerType (4 bytes): A MilWindowLayerType enumeration. The requested window layer type for this render target.

transparencyMode (4 bytes): A MilTransparencyFlags enumeration. The requested transparency mode for this render target.

constantAlpha (4 bytes): A 4-byte floating-point number. The opacity of the window, if transparency is enabled.

isChild (4 bytes): A 32-bit integer Boolean value. If this value is nonzero, the window associated with the rendering target specified by the targetResource field MUST be treated as a child window.

isRTL (4 bytes): A 32-bit integer Boolean value. If this value is nonzero, the window associated with the rendering target specified by the targetResource field MUST be treated as a right-to-left window.

renderingEnabled (4 bytes): A 32-bit integer Boolean value. If this value is set to zero, this render target MUST be disabled and the value of the disableCookie field MUST be stored for later use. If this value is nonzero, the value of the disableCookie field MUST be compared to the value of the disableCookie field as stored when disabling this render target, and if these values are equal this render target MUST be enabled.

colorKey (16 bytes): A MilColor structure. If the transparency mode flags specify that this render target is color-keyed, this value MUST be used as the color key.

disableCookie (4 bytes): A 32-bit unsigned integer that is used to match multiple MILCMD_TARGET_UPDATEWINDOWSETTINGS message instances sent to the same resource. If the renderingEnabled field is zero, the server MUST disable rendering of this target and store the value of the disableCookie field for later use. Otherwise, if the renderingEnabled field is non-zero, the server MUST:

  1. Compare the value of this field with the value it stored the last time it received a MILCMD_TARGET_UPDATEWINDOWSETTINGS message that targeted the same resource and had a zero value for the renderingEnabled field.

  2. Re-enable rendering for this target if and only if the two values match.