CeSetThreadQuantum

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

Reference

Process and Thread Functions