ISideShowSession 

Gadgets initiate a session with the Windows SideShow platform by using the ISideShowSession interface.

Members

Method

Description

RegisterContent

Registers the calling Windows SideShow gadget with the Windows SideShow platform so that it can send content to devices that support the specified endpoint.

RegisterNotifications

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

Show: