2.2.7.57 MILCMD_METABITMAPRENDERTARGET_CAPTUREBITS
The MILCMD_METABITMAPRENDERTARGET_CAPTUREBITS packet enqueues a rasterization and capture request to an offscreen render target. The client MUST respond with a MILMSG_METARTCAPTUREBITSREPLY notification containing the pixels representing the rasterization of the specified desktop area. The rasterization performed for the capture MUST adhere to the settings received in MILCMD_WINDOWNODE_PROTECTCONTENT messages, and it MUST black out the visible content area as specified by any received MILCMD_WINDOWNODE_PROTECTCONTENT messages.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
messageSize |
|||||||||||||||||||||||||||||||
controlCode |
|||||||||||||||||||||||||||||||
targetResource |
|||||||||||||||||||||||||||||||
Width |
|||||||||||||||||||||||||||||||
Height |
|||||||||||||||||||||||||||||||
UpdateId |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
IncludeCursors |
|||||||||||||||||||||||||||||||
unused |
|||||||||||||||||||||||||||||||
UpdateParam (40 bytes) |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
... |
messageSize (4 bytes): A 32-bit unsigned integer. The size of this message, in bytes. The value of this field MUST be set to 0x0000004C.
controlCode (4 bytes): A 32-bit unsigned integer containing the control code for this message. The value of this field MUST be equal to 0x0000004A.
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_METABITMAPRENDERTARGET. This handle identifies the resource that is the target for this message.
Width (4 bytes): A 32-bit unsigned integer. The width of the requested capture area in pixels.
Height (4 bytes): A 32-bit unsigned integer. The height of the requested capture area in pixels.
UpdateId (8 bytes): A 64-bit unsigned integer. Describes a unique identifier for the rasterization request. This identifier MUST be used by the server to correlate MILMSG_METARTCAPTUREBITSREPLY notifications with the outstanding rasterization requests.
IncludeCursors (4 bytes): A 32-bit unsigned integer. Describes how to render cursors during the render pass. Cursors MUST be rendered if, and only if, the value of this field is set to a nonzero value.
unused (4 bytes): A 32-bit unsigned integer. This field is unused and MUST be set to zero.
UpdateParam (40 bytes): A MAGN_UPDATE_TEXTURES_PARAM structure. Describes an affine transform to be applied to the root node of the visual tree when rasterizing the requested render target.