ISideShowSession
Gadgets initiate a session with the Windows SideShow platform by using the ISideShowSession interface.
Members
Method |
Description |
Registers the calling Windows SideShow gadget with the Windows SideShow platform so that it can send content to devices that support the specified endpoint. |
|
Registers the calling Windows SideShow gadget for notifications so that it can send notifications to the associated devices. |
Remarks
After starting up, a Windows SideShow gadget must create an instance of the Windows SideShow object that implements this interface. Then, the gadget must call the ISideShowSession::RegisterContent Method with the ID of the endpoint to which the gadget will send data. The ISideShowSession::RegisterContent Method returns a pointer to an instance of the ISideShowContentManager interface through which the gadget can send data to the relevant Windows SideShow-compatible devices. The returned interface pointer is valid for the lifetime of the gadget and can be used to send data to all of the devices for which the gadget is configured to supply data.
The RegisterNotifications method works in a similar manner, returning a pointer to an instance of the ISideShowNotificationManager interface through which the gadget can send notification data to the relevant Windows SideShow-compatible devices.
Windows SideShow gadgets create a single Component Object Model (COM) object that implements this interface by calling CoCreateInstance with the class identifier CLSID_SideShowSession. Gadgets need not keep a reference to this object throughout the lifetime of the gadget once they have used it to obtain the necessary ISideShowContentManager and ISideShowNotificationManager interfaces.
Example
This example demonstrates how to create an instance of the SideShowSession class and retrieve a pointer to its ISideShowSession interface.
[C++]
See Also
Concepts
ISideShowContentManager
ISideShowNotificationManager
Platform-Implemented Interfaces