2.2.2.13 RDPGFX_FRAME_ACKNOWLEDGE_PDU
The RDPGFX_FRAME_ACKNOWLEDGE_PDU message is sent by the client to indicate to the server that a logical frame of graphics commands has been successfully decoded. This message MUST be sent in response to an RDPGFX_END_FRAME_PDU (section 2.2.2.12) message, unless the client has opted out of this behavior.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
header |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
queueDepth |
|||||||||||||||||||||||||||||||
|
frameId |
|||||||||||||||||||||||||||||||
|
totalFramesDecoded |
|||||||||||||||||||||||||||||||
header (8 bytes): An RDPGFX_HEADER (section 2.2.1.5) structure. The cmdId field MUST be set to RDPGFX_CMDID_FRAMEACKNOWLEDGE (0x000D), while the flags field MUST be set to zero.
queueDepth (4 bytes): A 32-bit unsigned integer that either specifies the number of unprocessed bytes buffered at the client, or indicates to the server that the client will no longer be transmitting RDPGFX_FRAME_ACKNOWLEDGE_PDU messages.
-
Value
Meaning
QUEUE_DEPTH_UNAVAILABLE
0x00000000
Specifies that no information is available regarding the size, in bytes, of the graphics messages that have been buffered at the client and not yet processed.
0x00000001 – 0xFFFFFFFE
Specifies the size, in bytes, of the graphics messages that have been buffered at the client and not yet processed.
SUSPEND_FRAME_ACKNOWLEDGEMENT
0xFFFFFFFF
Indicates to the server that the client will no longer be transmitting RDPGFX_FRAME_ACKNOWLEDGE_PDU messages. The client can opt back into sending these messages by sending an RDPGFX_FRAME_ACKNOWLEDGE_PDU message with the queueDepth field set to a value in the range 0x00000000 to 0xFFFFFFFE (inclusive) in response to an RDPGFX_END_FRAME_PDU message.
frameId (4 bytes): A 32-bit unsigned integer that contains the ID of the frame being acknowledged. The ID of the frame is specified in the RDPGFX_START_FRAME_PDU (section 2.2.2.11) and RDPGFX_END_FRAME_PDU (section 2.2.2.12) messages.
totalFramesDecoded (4 bytes): A 32-bit unsigned integer that specifies the number of frames that have been decoded by the client since the connection was initiated.