Função CreateUmsThreadContext (winbase.h)

Artigo
03/03/2024

Cria um contexto de thread de UMS (agendamento no modo de usuário) para representar um thread de trabalho umS.

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 CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

Parâmetros

[out] lpUmsThread

Uma variável PUMS_CONTEXT. Na saída, esse parâmetro recebe um ponteiro para um contexto de thread umS.

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_NOT_ENOUGH_MEMORY	Não há memória suficiente disponível para criar o contexto de thread ums.

Comentários

Um contexto de thread UMS representa o estado de um thread de trabalho umS. Os contextos de thread são usados para especificar threads de trabalho ums em chamadas de função.

Um thread de trabalho da UMS é criado chamando a função CreateRemoteThreadEx depois de usar InitializeProcThreadAttributeList e UpdateProcThreadAttribute para preparar uma lista de atributos UMS para o thread.

As estruturas subjacentes para um contexto de thread umS são gerenciadas pelo sistema e não devem ser modificadas diretamente. Para obter e definir informações sobre um thread de trabalho umS, use as funções QueryUmsThreadInformation e SetUmsThreadInformation .

Depois que um thread de trabalho umS for encerrado, seu contexto de thread deverá ser liberado chamando DeleteUmsThreadContext.

Requisitos

Requisito	Valor
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 (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll
Conjunto de APIs	api-ms-win-core-ums-l1-1-0 (introduzido no Windows 7)