RtSetThreadTimeQuantum

RtSetThreadTimeQuantum sets the time quantum for the specified thread.

NOTE: This function is deprecated and will be removed from a future release. Use RtSetTimeQuantum.

Syntax

BOOL RtSetThreadTimeQuantum(
    HANDLE hThread,
    DWORD dwQuantumInMS
);

Parameters

hThread

The handle of the thread whose time quantum is to be set.

dwQuantumInMS

A new time quantum value in milliseconds. The amount of time the thread will run before it yields to another RTSS thread with the same priority.

Return Value

TRUE if the function succeeds, FALSE if the function fails

To get extended information, call GetLastError.

Remarks

In a Win32 environment, the only valid time quantum value is 0. This time quantum simulates Windows scheduling policy.

In an RTSS environment, the time quantum can be any value greater than or equal to zero. A value of zero means the RTSS thread will run to completion.

The default time quantum value can be changed in the Control Panel.

See Also:

RtGetThreadTimeQuantum