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 |
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 |
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