Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function sets the time, in milliseconds, required for the specified thread to run.

Syntax 

BOOL CeSetThreadQuantum(
  HANDLE 
hThread,
  DWORD 
dwTime
);

Parameters

hThread

[in] Handle to a thread.

dwTime

[in] Specifies the time, in milliseconds (ms), required for the thread to run.

Every thread in the system is allotted a time defined by the OEM, unless it is reset by a call to this function. The default value is 100 ms. If zero is specified, the thread runs to completion.

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.

Remarks

As long as no higher priority threads are ready to run, a thread runs for the length of the specified quantum.

Note:
The default 100-millisecond quantum is a change from earlier Windows Embedded CE releases, which used a 25-millisecond tick count to schedule threads.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also