Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IHomePluginEnvironment::SetSingleShotTimer

Windows Mobile 6.5
4/8/2010

The SetSingleShotTimer method causes a PE_TIMER event to be sent to the plug-in after a given amount of time. Calling this method results in one instance of a PE_TIMER event.

Bb160735.note(en-us,MSDN.10).gifNote:
Timer events reduce the amount of time the device can spend in a battery conservation mode; use this method sparingly.


HRESULT SetSingleShotTimer (
  HPLUGIN hPlugin,
  UINT cMiliseconds
);

hPlugin

[in] Handle to the plug-in for which the timer is set.

cMiliseconds

[in] Number of milliseconds the timer waits.

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

Indicates success.

To conserve the battery power of the device, avoid frequent use of this method; the extra processing required for activities such as polling and animation drains the battery more quickly.

Methods in the IHomePluginEnvironment must be called from the thread on which the plug-in was created.

To get your data to update from your worker thread, call ShOnPluginDataChange with the class ID of your plug-in. Your plug-in then receives a PE_DATACHANGE event. In response to the PE_DATACHANGE event, if the data change requires the plug-in be redrawn, call IHomePluginEnvironment::InvalidatePlugin.

Headerhome.h
Windows Embedded CEWindows CE 3.0 and later
Windows MobileSmartphone 2002 and later

Community Additions

Show:
© 2015 Microsoft