Share via

Função SetUmsThreadInformation (winbase.h)

  • Artigo

Define informações de contexto específicas do aplicativo para o thread de trabalho ums (agendamento de modo de usuário) especificado.

Aviso

A partir de Windows 11, não há suporte para o agendamento no modo de usuário. Todas as chamadas falham com o erro ERROR_NOT_SUPPORTED.

Sintaxe

BOOL SetUmsThreadInformation(
  [in] PUMS_CONTEXT          UmsThread,
  [in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [in] PVOID                 UmsThreadInformation,
  [in] ULONG                 UmsThreadInformationLength
);

Parâmetros

[in] UmsThread

Um ponteiro para um contexto de thread UMS.

[in] UmsThreadInfoClass

Um valor UMS_THREAD_INFO_CLASS que especifica o tipo de informação a ser definido. Esse parâmetro deve ser UmsThreadUserContext.

[in] UmsThreadInformation

Um ponteiro para um buffer que contém as informações a serem definidas.

[in] UmsThreadInformationLength

O tamanho do buffer UmsThreadInformation , em bytes.

Retornar valor

Se a função for bem-sucedida, ela retornará um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
ERROR_INFO_LENGTH_MISMATCH
 O tamanho do buffer não corresponde ao tamanho necessário para a classe de informações especificada.
ERROR_INVALID_INFO_CLASS
 O parâmetro UmsThreadInfoClass especifica uma classe de informações sem suporte.
ERROR_NOT_SUPPORTED
 Não há suporte para UMS.

Comentários

A função SetUmsThreadInformation pode ser usada para definir um contexto definido pelo aplicativo para o thread de trabalho umS especificado. As informações de contexto podem consistir em qualquer coisa que o aplicativo possa achar útil para acompanhar, como por agendador ou por estado de thread de trabalho. As estruturas subjacentes para threads de trabalho ums são gerenciadas pelo sistema e não devem ser modificadas diretamente.

A função QueryUmsThreadInformation pode ser usada para recuperar outras informações expostas sobre o thread especificado, como seu TEB (bloco de execução de thread) e se o thread está suspenso ou encerrado. As informações que não são expostas por meio de QueryUmsThreadInformation devem ser consideradas reservadas.

Requisitos

   
Cliente mínimo com suporte Windows 7 (somente 64 bits) [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll
Conjunto de APIs api-ms-win-core-ums-l1-1-0 (introduzido no Windows 7)

Confira também

QueryUmsThreadInformation