2.2.1.3 Draw GDI+ Capability Set (TS_DRAW_GDIPLUS_CAPABILITYSET)

The TS_DRAW_GDIPLUS_CAPABILITYSET structure is used to advertise the level of GDI+ 1.1 rendering and caching support and the GDI+ cache configuration. This capability is sent by both client and server. However, only the client initializes the GdipVersion, GdipCacheEntries, GdipCacheChunkSize, and GdipImageCacheProperties fields. The server uses this capability set only to advertise its level of GDI+ 1.1 rendering and caching support.


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

drawGDIPlusSupportLevel

GdipVersion

drawGdiplusCacheLevel

GdipCacheEntries

...

...

GdipCacheChunkSize

...

...

GdipImageCacheProperties

...

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

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.

drawGDIPlusSupportLevel (4 bytes): A 32-bit, unsigned integer. The level of support for GDI+ 1.1 remoting. This field MUST be set to one of the following values.

Value

Meaning

TS_DRAW_GDIPLUS_DEFAULT

0x00000000

GDI+ 1.1 is not supported.

TS_DRAW_GDIPLUS_SUPPORTED

0x00000001

GDI+ 1.1 is supported.

GdipVersion (4 bytes): A 32-bit, unsigned integer. The build number of the underlying GDI+ 1.1 subsystem. Only the client-to-server instance of the GDI+ Capability Set MUST contain a valid value for this field.

drawGdiplusCacheLevel (4 bytes): A 32-bit, unsigned integer. The level of support for the caching of GDI+ 1.1 rendering primitives. This field MUST be set to one of the following values.

Value

Meaning

TS_DRAW_GDIPLUS_CACHE_LEVEL_DEFAULT

0x00000000

Caching of GDI+ 1.1 rendering primitives is not supported.

TS_DRAW_GDIPLUS_CACHE_LEVEL_ONE

0x00000001

Caching of GDI+ 1.1 rendering primitives is supported.

GdipCacheEntries (10 bytes): A GDI+ Cache Entries (section 2.2.1.3.1) structure that specifies the total number of entries within the GDI+ Graphics, Pen, Brush, Image, and Image Attributes caches. Only the client-to-server instance of the GDI+ Capability Set MUST contain a valid value for this field.

GdipCacheChunkSize (8 bytes): A GDI+ Cache Chunk Size structure that specifies the size of individual entries in the GDI+ Graphics, Brush, Pen, and Image Attributes caches. Only the client-to-server instance of the GDI+ Capability Set MUST contain a valid value for this field.

GdipImageCacheProperties (6 bytes): A GDI+ Image Cache Properties structure that contains sizing information for the GDI+ Image cache. Only the client-to-server instance of the GDI+ Capability Set MUST contain a valid value for this field.