2.2.1.2 DrawNineGrid Cache Capability Set (TS_DRAW_NINEGRID_CAPABILITYSET)

The TS_DRAW_NINEGRID_CAPABILITYSET structure is used to advertise support for NineGrid bitmap caching and rendering (see sections 2.2.2.2.1.1.2.21, 2.2.2.2.1.1.2.22, and 2.2.2.2.1.3.4). This capability set is sent only from client to server.


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

capabilitySetType

lengthCapability

drawNineGridSupportLevel

drawNineGridCacheSize

drawNineGridCacheEntries

capabilitySetType  (2 bytes): A 16-bit, unsigned integer. The type of the capability set. This field MUST be set to CAPSTYPE_DRAWNINEGRIDCACHE (0x0015).

lengthCapability (2 bytes): A 16-bit, unsigned integer. The length, in bytes, of the capability data, including the size of the capabilitySetType and lengthCapability fields.

drawNineGridSupportLevel (4 bytes): A 32-bit, unsigned integer. The level of support for NineGrid drawing. This field MUST be set to one of the following values.

Value

Meaning

DRAW_NINEGRID_NO_SUPPORT

0x00000000

NineGrid bitmap caching and rendering is not supported.

DRAW_NINEGRID_SUPPORTED

0x00000001

Revision 1 NineGrid bitmap caching and rendering is supported. The Revision 1 versions of the stream bitmap alternate secondary orders (see section 2.2.2.2.1.3.5) MUST be used to send the NineGrid bitmap from server to client.

DRAW_NINEGRID_SUPPORTED_REV2

0x00000002

Revision 2 NineGrid bitmap caching and rendering is supported. The Revision 2 versions of the stream bitmap alternate secondary orders (see section 2.2.2.2.1.3.5) MUST be used to send the NineGrid bitmap from server to client.

drawNineGridCacheSize (2 bytes): A 16-bit, unsigned integer. The maximum size of the NineGrid Bitmap Cache. The largest size allowed by current RDP servers is 2,560 kilobytes.

drawNineGridCacheEntries (2 bytes): A 16-bit, unsigned integer. The maximum number of entries allowed in the NineGrid Bitmap Cache. The maximum number of entries allowed by current RDP servers is 256.