SideShow OS Design Development (Windows CE 5.0)
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
10/16/2008
You can develop an operating system (OS) design that provides support for SideShow. When you create your OS by selecting features that are Catalog items, you can include support for different kinds of SideShow functionality by selecting the corresponding SideShow Catalog items.
Catalog Items
SideShow for Windows Embedded CE provides the following Catalog items that you can include in your OS design:
| Catalog item | Sysgen variable | Description |
|---|---|---|
SideShow Service |
SYSGEN_SIDESHOW |
Enables a device to act as a client to SideShow Gadgets running on Windows Vista. Gadgets are small programs which can push content to the device and receive commands from the device. Gadgets can send data such as, but not limited to, e-mail, weather, stock quotes, calendar data, pictures, or any other data which a gadget has been enabled for on the Windows Vista computer. |
SideShow Bluetooth Transport |
SYSGEN_SIDESHOW_BTH |
Provides support for SideShow over Bluetooth connections. The transport component that supports SideShow over Bluetooth connections. |
SideShow IP with SSL Transport |
SYSGEN_SIDESHOW_ETH_SSL_ONLY |
Provides support for SideShow over IP connections by using SSL encryption, which protects the user’s personal information. |
SideShow IP without SSL Transport |
SYSGEN_SIDESHOW_ETH_NO_SSL |
Provides support for SideShow over IP connections without any encryption to protect the transmitted data. |
SideShow USB Transport |
SYSGEN_SIDESHOW_USB |
Provides support for SideShow over USB connections. By default, this Catalog item will not function correctly in an OS design that supports ActiveSync Desktop Pass-through (DTPT) over USB. To change this default behavior, see the next section, Including Both SideShow USB Transport and DTPT in an OS Design. |
Including Both SideShow USB Transport and DTPT in an OS Design
If you have included ActiveSync Desktop Pass-through (DTPT) in your OS design and you also want to add support for the SideShow USB transport, you must write an application that selects a new default USB driver by modifying the registry, and then reboots the Windows Embedded CE powered device.
The default USB client driver for DTPT is defined in common.reg, and is defined for SideShow in servers.reg.
When the SideShow USB transport is included in a run-time image, the SideShow USB function driver (SideShowUSBFn) is the default USB driver. However, ActiveSync DTPT must use USB Serial. To change the default driver to USB Serial, you must write code that reads the registry key HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers and replaces the DefaultClientDriver value from the following registry entry:
"DefaultClientDriver"="SideShowUsbFn"
to the following registry value:
"DefaultClientDriver"="Serial_Class"
For more information about modifying the registry, see Registry Functions.
The following registry code in common.reg shows two possible registry values for the USB serial driver used by ActiveSync:
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"=- ; erase previous default
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"="Serial_Class" ; sets ActiveSync USB as default
The following registry code in servers.reg shows two possible registry values for the USB SideShow driver used by SideShow:
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"=- ; erase previous default
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"="SideShowUsbFn" ; sets SideShow USB as default
Note
ActiveSync DTPT is a feature that can be included in a portable navigation device (PND) run-time image, which lets the PND connect to a desktop computer through a USB cable.
See Also
Reference
Adding Catalog Items to an OS Design
Adding an Item from the Catalog
Concepts
SideShow Architecture
SideShow Security