Device Capabilities 

In the WindowsSideShow.h header file, the Windows SideShow platform defines a set of PROPERTYKEY values for use in the in_keyCapability parameter of the ISideShowCapabilities::GetCapability Method method of the ISideShowCapabilities interface.

The following table shows these PROPERTYKEY definitions and the corresponding variant types of their returned device capability values.

Device capability (PROPERTYKEY)

Variant type

Capability description

SIDESHOW_CAPABILITY_DEVICE_ID

VT_LPWSTR

A unique string identifier that a gadget may use to differentiate between devices. This value is not guaranteed to be unique between gadget instances; therefore treat it as an opaque value. The value should not be parsed and is subject to change in future revisions of the platform.

SIDESHOW_CAPABILITY_SCREEN_TYPE

(SIDESHOW_SCREEN_TYPE Enumeration)

VT_I4

Indicates whether the device is capable of displaying bitmap images or text.

SIDESHOW_CAPABILITY_SCREEN_WIDTH

VT_UI2

The width of the screen on the device, in pixels.

SIDESHOW_CAPABILITY_SCREEN_HEIGHT

VT_UI2

The height of the screen on the device, in pixels.

SIDESHOW_CAPABILITY_COLOR_DEPTH

VT_UI2

The bit depth of the device.

SIDESHOW_CAPABILITY_COLOR_TYPE

(SIDESHOW_COLOR_TYPE Enumeration)

VT_I4

The type of color supported by the device.

SIDESHOW_CAPABILITY_DATA_CACHE

VT_BOOL

VARIANT_TRUE if the device supports caching data; otherwise VARIANT_FALSE.

SIDESHOW_CAPABILITY_SUPPORTED_LANGUAGES

VT_LPWSTR

The languages that the device supports. The value is a combination of the locale identifier (such as en-US) combined with the number of supported font sizes for that language, separated by a colon. Each language is delimited by a semi-colon. For example, a device that supports US English and German, and one and two font sizes, respectively, returns en-US:1;de-DE:2;.The locale identifier is a two character language code followed by a two character country code.

SIDESHOW_CAPABILITY_CURRENT_LANGUAGE

VT_LPWSTR

A locale identifier for the language, followed by the font size number currently being used. For example, a device using US English with a large font returns en-US:2.

SIDESHOW_CAPABILITY_SUPPORTED_THEMES

VT_LPWSTR

The names of the themes that this device supports returned as a semicolon-delimited list.

SIDESHOW_CAPABILITY_SUPPORTED_IMAGE_FORMATS

VT_LPWSTR

The image formats that are supported by the device, returned as a semicolon-delimited list of MIME image types. For example, image/bmp;image/gif.

SIDESHOW_CAPABILITY_CLIENT_AREA_WIDTH

VT_LPWSTR

The width of the client area on the device, in pixels. The client area is the screen size excluding any system or title bars.

SIDESHOW_CAPABILITY_CLIENT_AREA_HEIGHT

VT_UI2

The height of the client area on the device, in pixels. The client area is the screen size excluding any system or title bars.

See Also

Reference

Locale and Language Identifier Constants and Strings

Concepts

ISideShowCapabilities