SetThreadPriority

9/8/2008

Essa função define o valor prioridade para o segmento especificado.

Syntax

BOOL SetThreadPriority(
  HANDLE hThread,
  int nPriority
);

Parameters

• hThread
  [no] Identificador para o segmento cujo valor prioridade deve ser definido.

• nPriority
  [no] Especifica o valor prioridade para o segmento.

  A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  THREAD_PRIORITY_TIME_CRITICAL	Indica 3 pontos acima prioridade normal.
  THREAD_PRIORITY_HIGHEST	Indica 2 pontos acima prioridade normal.
  THREAD_PRIORITY_ABOVE_NORMAL	Indica 1 point acima prioridade normal.
  THREAD_PRIORITY_NORMAL	Indica prioridade normal.
  THREAD_PRIORITY_BELOW_NORMAL	Indica 1 point abaixo prioridade normal.
  THREAD_PRIORITY_LOWEST	Indica 2 pontos abaixo prioridade normal.
  THREAD_PRIORITY_ABOVE_IDLE	Indica 3 pontos abaixo prioridade normal.
  THREAD_PRIORITY_IDLE	Indica 4 pontos abaixo prioridade normal.

  Observação

  A prioridade níveis zero a 7 que foram disponível nas versões anteriores do Windows Embedded CE agora é mapeados para níveis prioridade 248 a 255.Esses nomes simbólicos prioridade devem ser usados apenas com SetThreadPrioritye não com CeSetThreadPriority.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Windows Embedded CE faz não suporte prioridade classes. A ordem na qual segmentos são agendados é determinado apenas pela suas prioridades segmento.

Essa função permite configuração o nível de prioridade de base de um segmento sem considerar classes prioridade.

Segmentos estão agendados em um modo round-robin em cada nível de prioridade. Segmentos em um nível inferior são agendados somente quando há segmentos executáveis existem em um nível mais alto.

Todos os segmentos inicialmente iniciar no THREAD_PRIORITY_NORMAL (251).

Use a função GetThreadPriority para get valor de prioridade de um segmento.

Usar valores prioridade segmento para diferenciar o relativo prioridades das tarefas de um processo. De exemplo, um segmento que lida com entrada para uma janela pode ter um nível de prioridade maior do que um segmento que efetue cálculos intensos para o CPU.

Quando manipular prioridades, verifique se ser uma alta - prioridade segmento não consumir todos disponível tempo de CPU.

Para obter mais informações sobre níveis prioridade em Windows Embedded CE, consulte Priority Levels.

Requirements

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

See Also

Reference

Process and Thread Functions
GetThreadPriority
CeSetThreadPriority