DosGetPrty

This call gets the priority of the initial thread of execution for any process, or any thread in the current process.

DosGetPrty

(Scope, Priority, ID)

Scope (USHORT) - input

Scope of priority request. Used to define the scope of the request.

Value

Definition
0
Thread 1 (the initial thread of execution) of the indicated process.
2
Any thread of the current process.
Priority (PUSHORT) - output
Address of the base priority of the thread identified by ID. The high-order byte of this word is set equal to the priority class. The low-order byte is set equal to the priority level.
ID (USHORT) - input
A process ID (scope = 0) or a thread ID (scope = 2). If this operand is equal to 0, the current process or thread is assumed.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 303
  ERROR_INVALID_PROCID
  308
  ERROR_INVALID_SCOPE
  309
  ERROR_INVALID_THREADID
  Remarks

  If scope = 0 (process) the priority of the first thread of a process is returned. If that thread has terminated, the ERROR_INVALID_THREAD_ID error code is returned.

  A thread's priority is changed by issuing DosSetPrty. A process can change the priority of all the threads of any process whose process ID is known to the thread. It can also change the priority of another thread in its process, or all the threads of the current or a child process, as well as all its descendants.

  DosGetPID and DosGetPPID are useful for obtaining process and thread IDs. DosGetPID gets the ID of the current thread, the process ID of its current process, or the process ID of the parent process of the current process. DosGetPPID gets the parent process ID of any specified process.

  ---

  [Back: DosGetProcAddr]
  [Next: DosGetResource]